Content
81%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.
An operationally dense, command-rich workflow document: every state transition has an exact CLI invocation, the four build steps are clearly sequenced with explicit validation gates and error-recovery loops, and detail is appropriately delegated to conditionally loaded reference files. The weaknesses are presentational rather than structural — some redundant repetition of continuation-reuse rules, delegation of step substance to external references, and paragraph density that makes the routing logic harder to scan. A strong, highly actionable skill body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | There is no padding or teaching of concepts Claude already knows — every sentence is operational. However, the continuation-reuse rule is stated redundantly ("优先使用同次结果的 agent.continuation / data.nextAction" appears in both the SDK entry paragraph and the post-advance paragraph), and the 'first entry / agent switch / context recovery, otherwise reuse' pattern recurs several times, so it could be tightened. Efficient with minor trim opportunities matches anchor 4, not anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | The body supplies copy-paste-ready CLI commands with flags for every state transition ("comet state propose-build <change-name> --file <configuration-json> --confirmed", "comet guard <change-name> build --apply -- <program> [args...]", "comet state complete-build <change-name> --session <builder-execution-ref>") plus concrete routing and recovery instructions. It stays at anchor 4 rather than 5 because the substantive content of steps 1–3 is delegated to the external reference ("按 SDK 方法参考的 Build 章节") and details such as the temp-configuration JSON format are unspecified — minor gaps, not vague direction. | 4 / 5 |
Workflow Clarity | The four full.build.* steps are clearly sequenced as a numbered list with explicit step IDs, and validation checkpoints are explicit: guard --apply "重新校验当前任务、配置、工作区和证据" before real checks, tasks checked off only "任务实际完成且审查合格后". Feedback loops are spelled out for error recovery — "失败后按返回的当前 Build Action 修复并重新验证", "拒绝后从新配置重新提案", and interrupted receipts are reconciled rather than re-executed. This matches anchor 5 (clear sequence, explicit validation, feedback loops) and exceeds anchor 4's 'most checkpoints present'. | 5 / 5 |
Progressive Disclosure | The file acts as an overview/router with clearly signaled, conditionally loaded, one-level-deep references ([阶段入口与恢复](../comet-classic/reference/sdk-methods.md#阶段入口与恢复), [Compat 操作](reference/compat.md), [变更说明](../comet/reference/change-walkthrough.md)). It sits at anchor 4 rather than 5 because references span multiple sibling skills (../comet-classic/, ../comet/) with one unpathed reference ("按 decision-point.md 等待确认"), no bundle files exist in this workspace to verify referenced paths, and dense paragraph walls within the SDK section impede easy navigation. | 4 / 5 |
Total | 17 / 20 Passed |