Content
77%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is an efficiently written, highly actionable protocol skill with an exemplary validation-gated workflow (confirmation gates, local checks, eval loops, install preview, recovery boundaries). Its one structural defect is that both references point to reference/sdk-creation.md, which is not present in the bundle, leaving the core action/recovery detail unreachable.
Suggestions
Fix or ship the dangling reference: the body links reference/sdk-creation.md twice but no such file (or references/ directory) exists in the skill bundle — either include it (e.g., under references/) or correct the path.
Add the concrete command syntax for submitting actions/decisions (e.g., how to submit the user decision for `confirm-plan` or a completed stage), since the gates are named but the submission mechanism is only described.
Deduplicate the repeated recovery stance (“保留现场” appears in three sections) into the 恢复边界 section and reference it once.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and lean — no concept explanations Claude already knows, every sentence is instruction, e.g. “凭据仅通过执行环境注入,不写入方案、源码、生成包、Run 或报告”. It falls just short of anchor 5 because of minor repetition: the recovery stance “保留现场” is restated across 分析与方案, 确认 and 恢复边界, and the reference to 创作动作与恢复 is repeated twice. | 4 / 5 |
Actionability | Concrete executable commands with full flags are given, e.g. `comet creator status <name> --project <项目> --json`, `comet creator start <name> --project <项目> --goal <用户目标> --install-target <相对目录> --host codex|claude-code --json`, and named gates (confirm-plan, confirm-eval, review-eval, confirm-install). Falls short of anchor 5 because the actual syntax for submitting/committing an action (how to submit a user decision on `confirm-plan` or submit a stage) is never shown, only described. | 4 / 5 |
Workflow Clarity | The multi-phase sequence is explicit (开始或继续 → 分析与方案 → 确认、验证与交付 → 恢复边界) with strong validation checkpoints and feedback loops: “这些本地检查必须通过才可安装”, “失败时保留现场,修正方案或产物后沿原 Action 恢复”, eval retry/revise/skip decision points, and preview-before-install with re-confirmation on any change. This matches the top anchor including error-recovery loops. | 5 / 5 |
Progressive Disclosure | The single external reference [创作动作与恢复](reference/sdk-creation.md) is well-signaled with explicit read conditions (“首次领取或提交动作前,读取…”), but the referenced file does not exist in the skill bundle (no references/, reference/, scripts/ or assets/ directories are present), so the navigation is dangling. Structure and signaling alone fit anchor 3–4; the unverifiable/missing reference path pulls it to 3. | 3 / 5 |
Total | 16 / 20 Passed |