AGENT SKILL

skill-contract-reviewer

Validate an Agent Skill package and choose the right instruction, capability, or lifecycle primitive before implementation.

License 许可
MIT
最近更新
2026-11-12
Stars
★ 1.3k
Forks
195

01 前言 Front Matter

name
skill-contract-reviewer
license
MIT
metadata
{ "lesson": "22" }
description
Validate an Agent Skill package and choose the right instruction, capability, or lifecycle primitive before implementation.

02 资源文件 4

03 SKILL.md 正文

Skill 契约审查器

当工作流即将成为可复用的 agent 产物时,使用此 skill。

  1. 将 SKILL_ROOT 设为包含本已安装 SKILL.md 的绝对目录。不要假定进程工作目录就是 Bundle。
  2. 将 TARGET_ROOT 设为原始工作区的绝对工作目录,并在该根目录下解析候选 skill 目录。
  3. 读取 $SKILL_ROOT/references/contract.md,验证可移植 SKILL.md 的标识字段。
  4. 读取 $SKILL_ROOT/references/decision-model.md,区分仓库上下文、可复用方法、外部能力、生命周期时机、确定性逻辑和隔离委派。
  5. 执行前展示精确解析后的参数向量。运行 python3 "$SKILL_ROOT/scripts/check_skill.py" "$TARGET_SKILL",其中 TARGET_SKILL 是 TARGET_ROOT 下候选 skill 的绝对目录。
  6. 检查 JSON 报告。讨论 host 专属扩展前,修复全部错误。
  7. 将候选产物与 $SKILL_ROOT/assets/task-shapes.json 比较,返回最小可组合原语集合。

不要声称运行时扩展属于可移植契约。不要将有效 skill 视作运行脚本或访问工具的权限。

返回验证报告、所选原语和解释每项选择的一句话。附上执行证据:解析后的脚本路径、目标路径、cwd、精确 argv 与退出码。若 host 无法暴露其中某项观察,将其标为未验证,不要虚构。

04 同仓库更多 Skills

fancyboi999
fancyboi999/ai-engineering-from-scratch-zh

write-manual

为一个固定版本的技术主题编写长篇手册,从用途讲到每个请求与响应。 每个示例来自离线运行记录,每个断言追溯到按权威排序的来源,审计必须达到 TOTAL 0。 用于“编写手册”“为某主题写入门手册”“manual.json”“增加手册章节” “构建运行记录工具”“审计手册”“固定规范版本并文档化”。

★ 1.3k
fancyboi999
fancyboi999/ai-engineering-from-scratch-zh

start-learning

AI Engineering from Scratch 课程的一次性入门流程(523 节课、20 个阶段)。访谈学习者、 运行分级测验,并写入由 learn skill 驱动的持久学习计划 LEARNING.md。触发短语: “开始学习”、“设置课程”、“开始课程”、“带我入门”、“创建学习计划”,或 "start learning", "set up the course", "begin the curriculum", "onboard me", "create my learning plan"

★ 1.3k
fancyboi999
fancyboi999/ai-engineering-from-scratch-zh

mcpa-certification

AI Engineering from Scratch 中文版中的 MCPA(Model Context Protocol Associate)AI 原生导师与入门流程。学习者需要备考 MCPA、继续认证路线、 交互式学习下一课、运行并验证实践实验、参加诊断或全真模拟、根据薄弱领域 补弱时使用。适用于 Claude Code、Codex、ChatGPT、Cursor 或其他 agent。

★ 1.3k
fancyboi999
fancyboi999/ai-engineering-from-scratch-zh

lesson-screen

课程导师在终端教学时,在旁边打开浏览器学习屏幕。展示课程已注册的图表、带真实数值的 代码执行过程和可点击的预测题。也可结合课程与宿主已安装的图表技能,为当前课程制作 蓝图、机制图、等距机器或 3D 模型。点击以事件形式返回导师。 触发短语:“打开学习屏幕”、“用图展示”、“用 3D 展示”、“画出架构”、“为这节课制作图表”, 或 "open the lesson screen", "show me this visually", "show this in 3D", "draw the architecture", "visualize this lesson", "build a figure for this lesson", "lesson screen"。

★ 1.3k
fancyboi999
fancyboi999/ai-engineering-from-scratch-zh

learn

AI Engineering from Scratch 课程的交互式课程 tutor。读取 LEARNING.md,获取下一课, 在终端按章节教学,结尾测验并记录进度。可在克隆仓库中或完全通过 raw.githubusercontent.com 工作—— 无需设置。触发短语:“下一课”、“教我”、“继续课程”、“我们来学习”、“继续学习”,或 "next lesson", "teach me", "continue the course", "let's learn", "resume learning"

★ 1.3k
fancyboi999
fancyboi999/ai-engineering-from-scratch-zh

learn-reverse-engineering

从零开始学 AI 工程中逆向工程专项路径的交互导师。学习者希望读取编译后的程序时, 用于开始或继续文件格式、反汇编、控制流、表示提升、证据、等价证明、调用约定、 编译器惯用模式、链接、类型、调试、字节码、差分、符号执行和 AI 辅助分析。 每次调用讲授一课,并将证据记录到 REVERSE-ENGINEERING-LEARNING.md。

★ 1.3k