用途
Skill 契约审查器用于在实现之前验证一个 Agent Skill 包，并帮助选择正确的指令、能力或生命周期原语。它适用于某个工作流即将成为可复用 agent 产物的场景。
主要能力
- 读取 $SKILL_ROOT/references/contract.md，验证可移植 SKILL.md 的标识字段。
- 读取 $SKILL_ROOT/references/decision-model.md，区分仓库上下文、可复用方法、外部能力、生命周期时机、确定性逻辑和隔离委派。
- 运行验证脚本并检查 JSON 报告，要求先修复全部错误，再讨论 host 专属扩展。
- 将候选产物与 $SKILL_ROOT/assets/task-shapes.json 比较，返回最小可组合原语集合。
- 输出验证报告、所选原语及每项选择的一句话解释，并附执行证据。
使用方式
- 将 SKILL_ROOT 设为包含本已安装 SKILL.md 的绝对目录，不要假定进程工作目录就是 Bundle。
- 将 TARGET_ROOT 设为原始工作区的绝对工作目录，并在该根目录下解析候选 skill 目录。
- 执行前展示精确解析后的参数向量。
- 运行 python3 "$SKILL_ROOT/scripts/check_skill.py" "$TARGET_SKILL"，其中 TARGET_SKILL 是 TARGET_ROOT 下候选 skill 的绝对目录。
- 检查 JSON 报告，修复全部错误。
- 与 assets/task-shapes.json 比较，返回最小可组合原语集合。
适用场景
当工作流即将成为可复用的 agent 产物，需要在实现前验证 SKILL.md 可移植性、判断应使用指令、能力还是生命周期原语时使用。
限制
- 不要声称运行时扩展属于可移植契约。
- 不要将有效 skill 视作运行脚本或访问工具的权限。
- 若 host 无法暴露某项观察（如脚本路径、目标路径、cwd、argv、退出码），应将其标为未验证，不要虚构。
- 资料未提供收费、价格、平台支持范围等信息。