| name | skill-contract-reviewer |
| description | Validate an Agent Skill package and choose the right instruction, capability, or lifecycle primitive before implementation. |
| license | MIT |
| metadata | {"lesson":"22"} |
Skill 契约审查器
当工作流即将成为可复用的 agent 产物时,使用此 skill。
- 将
SKILL_ROOT 设为包含本已安装 SKILL.md 的绝对目录。不要假定进程工作目录就是 Bundle。
- 将
TARGET_ROOT 设为原始工作区的绝对工作目录,并在该根目录下解析候选 skill 目录。
- 读取
$SKILL_ROOT/references/contract.md,验证可移植 SKILL.md 的标识字段。
- 读取
$SKILL_ROOT/references/decision-model.md,区分仓库上下文、可复用方法、外部能力、生命周期时机、确定性逻辑和隔离委派。
- 执行前展示精确解析后的参数向量。运行
python3 "$SKILL_ROOT/scripts/check_skill.py" "$TARGET_SKILL",其中 TARGET_SKILL 是 TARGET_ROOT 下候选 skill 的绝对目录。
- 检查 JSON 报告。讨论 host 专属扩展前,修复全部错误。
- 将候选产物与
$SKILL_ROOT/assets/task-shapes.json 比较,返回最小可组合原语集合。
不要声称运行时扩展属于可移植契约。不要将有效 skill 视作运行脚本或访问工具的权限。
返回验证报告、所选原语和解释每项选择的一句话。附上执行证据:解析后的脚本路径、目标路径、cwd、精确 argv 与退出码。若 host 无法暴露其中某项观察,将其标为未验证,不要虚构。