git:20261008.c74aa9d to git:20261018.a719150

22 added, 25 removed. Audit A to A.

---

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 contract reviewer

+ <a id="skill-contract-reviewer"></a>

- Use this skill when a workflow is about to become a reusable agent artifact.

+ # 技能契约审查器

- 1. Set `SKILL_ROOT` to the absolute directory containing this installed

- `SKILL.md`. Do not assume the process working directory is the bundle.

- 2. Set `TARGET_ROOT` to the absolute original workspace working directory and

- resolve the proposed skill directory under that root.

- 3. Read `$SKILL_ROOT/references/contract.md` and validate the portable

- `SKILL.md` identity fields.

- 4. Read `$SKILL_ROOT/references/decision-model.md` and separate repository

- context, reusable method, external capability, lifecycle timing,

- deterministic logic, and isolated delegation.

- 5. Before execution, show the exact resolved argument vector. Run

- `python3 "$SKILL_ROOT/scripts/check_skill.py" "$TARGET_SKILL"`, where

- `TARGET_SKILL` is the absolute proposed skill directory under

- `TARGET_ROOT`.

- 6. Inspect the JSON report. Fix every error before discussing host-specific

- extensions.

- 7. Compare the proposed artifact with

- `$SKILL_ROOT/assets/task-shapes.json` and return the smallest composable set

- of primitives.

+ 当某个工作流即将成为可复用的智能体产物时，使用此技能。

- Do not claim that a runtime extension is part of the portable contract. Do not treat a valid skill as permission to run scripts or access tools.

+ 1. 将 `SKILL_ROOT` 设为包含已安装 `SKILL.md` 的绝对目录。

+ 2. 将 `TARGET_ROOT` 设为原始工作区的绝对工作目录，

+ 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` 下的拟议技能目录的绝对路径。

+ 6. 检查 JSON 报告。在讨论宿主特有扩展之前，修复每一项错误。

+ 7. 将拟议产物与 `$SKILL_ROOT/assets/task-shapes.json` 比较，

+ 返回可组合的最小原语集合。

- Return the validation report, the selected primitives, and one sentence

- explaining each selection. Include execution evidence with the resolved script

- path, resolved target path, cwd, exact argv, and exit code. If the host cannot

- expose one of those observations, mark it unverified instead of inventing it.

+ 不要声称运行时扩展属于可移植契约。不要将一个结构有效的技能视为运行脚本或访问工具的授权。

+ 返回验证报告、选定原语，以及解释每项选择的一句话。

+ 附上执行证据，包括解析后的脚本路径、目标路径、cwd、准确的 argv 和退出码。

+ 如果宿主无法提供某项观测，将其标为未验证，不要编造。