Content
60%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 skill body is a well-structured, validation-heavy instruction document with clear sequencing and appropriately signaled, real one-level references, but it leans verbose and mixes concrete commands with long conditional policy prose that limits conciseness and copy-paste actionability.
Suggestions
Convert the long policy-combination rules (item_progression/milestone_commit/remote_publish legality) into a compact table to cut tokens and improve scanability.
Add a short worked example of one full epic lifecycle (proposed -> gate -> active -> milestone -> accepted) with the concrete cursor field values at each step to raise actionability.
Tighten or move repeated qualifier clauses (e.g. repeated '不新增 owner gate / 不替代 review / 不推断授权') into a single consolidated invariants section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense but largely free of padding and does not explain concepts Claude already knows; however several paragraphs (e.g. the 拆解 confirmation and policy-combination sentences) run very long with repeated qualifiers that could be tightened into tables or shorter rules. | 3 / 5 |
Actionability | Guidance is concrete in places (e.g. "shasum -a 256 <epic-file>", explicit file templates, named frontmatter fields) but much of it is conditional prose and policy enumeration rather than copy-paste-ready commands or worked examples, leaving key execution details implicit. | 3 / 5 |
Workflow Clarity | The hard-gate section sequences a clear multi-step lifecycle (proposed -> active -> executing -> acceptance) with explicit validation checkpoints (review rounds, blocking/important handling, milestone commits) and error-recovery feedback loops; minor gaps remain in some implicit transitions. | 4 / 5 |
Progressive Disclosure | Structure is well organized into clearly headed sections with three one-level-deep, conditionally-loaded references (shared-language.md, wayfinding.md, parallel-execution.md) that are all real files in ./references/ and signaled only-when-needed; the main body still inlines substantial policy detail that could be further split. | 4 / 5 |
Total | 14 / 20 Passed |