Agent Skills › fancyboi999/ai-engineering-from-scratch-zh › skill-contract-reviewer

skill-contract-reviewer

GitHub

用于在 Agent Skill 实现前验证其可移植性契约，通过脚本检查并匹配最小可组合原语，确保符合标准规范。

phases/13-tools-and-protocols/22-skills-and-agent-sdks/outputs/skill-contract-reviewer/SKILL.md fancyboi999/ai-engineering-from-scratch-zh

Trigger Scenarios

即将发布可复用的 Agent Skill 包需要验证 SKILL.md 是否符合契约标准

Install

npx skills add fancyboi999/ai-engineering-from-scratch-zh --skill skill-contract-reviewer -g -y

More Options

Non-standard path

npx skills add https://github.com/fancyboi999/ai-engineering-from-scratch-zh/tree/main/phases/13-tools-and-protocols/22-skills-and-agent-sdks/outputs/skill-contract-reviewer -g -y

Use without installing

npx skills use fancyboi999/ai-engineering-from-scratch-zh@skill-contract-reviewer

指定 Agent (Claude Code)

npx skills add fancyboi999/ai-engineering-from-scratch-zh --skill skill-contract-reviewer -a claude-code -g -y

安装 repo 全部 skill

npx skills add fancyboi999/ai-engineering-from-scratch-zh --all -g -y

预览 repo 内 skill

npx skills add fancyboi999/ai-engineering-from-scratch-zh --list

SKILL.md

Frontmatter

{
    "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."
}

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 比较，返回最小可组合原语集合。