Content
88%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 a strong instruction-only runbook: highly actionable CLI commands with defined placeholders, a clearly sequenced four-phase workflow with explicit validation checkpoints, and genuine error-recovery and escalation feedback loops. Token efficiency is good apart from a duplicated continuation-reuse rule and some overly dense run-on steps. The main structural caveat is that every detail reference points to sibling-skill files that are not part of this bundle, so none can be verified locally.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational prose with no padding and no explanations of concepts Claude already knows, fitting 'Efficient; minor instances of over-explanation that could be trimmed'. The continuation-reuse rule ('优先复用 agent.continuation / data.nextAction… 仅在冷恢复、外部状态变化或缺少必要信息时补读') is stated twice (SDK Run 路径 intro and the paragraph after step 4), and steps 1-2 are long run-on sentences that could be tightened, keeping it below anchor 5. | 4 / 5 |
Actionability | The guidance is fully executable with concrete, copy-paste-ready commands and defined placeholders throughout: 'comet classic workspace prepare <name> --isolation <selected-isolation> --json', 'comet guard <change-name> open --apply --approval-hash <approvalHash>', 'comet state propose-escalation <change-name> --reason "<reason>"', 'comet state decide-escalation … --choice <continue|upgrade>', 'comet guard <change-name> build --apply -- <program> [args...]'. This matches anchor 5's 'copy-paste ready code or commands; specific examples cover the common cases' — as an instruction-only orchestration skill, its guidance is maximally actionable. | 5 / 5 |
Workflow Clarity | The SDK Run path gives a clearly numbered Open→Build→Verify→Archive sequence with explicit validation checkpoints (preview then apply with approval hash, re-preview after artifact changes, '--apply 会重新校验当前任务、配置、工作区和证据'), explicit error-recovery loops ('失败后使用返回的当前状态…不重播结果未明的 Action', reconcile recovery), and an escalation decision workflow with user confirmation — matching anchor 5's 'Clear sequence with explicit validation steps; feedback loops for error recovery'. | 5 / 5 |
Progressive Disclosure | Structure is good: the SKILL.md is an orchestration overview that delegates detail to clearly signaled, one-level-deep, section-anchored references ('../comet-classic/reference/sdk-methods.md#阶段入口与恢复', 'reference/compat.md', '../comet/reference/change-walkthrough.md'), matching anchor 4's 'Good structure; most content appropriately placed; references mostly clear'. It falls short of anchor 5 because all referenced files live in sibling skills and none are present in this bundle — including the self-relative 'reference/compat.md' — so reference targets cannot be verified, and steps 1-2 pack several procedures into dense paragraphs that could be better organized. | 4 / 5 |
Total | 18 / 20 Passed |