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.
The body is a well-structured, dense orchestration guide with a clear sequenced workflow, explicit validation checkpoints and error-recovery feedback loops, and precise state-management rules. Its main weaknesses are minor redundancy between the execution-flow and re-entry sections, and that its key mechanism and reference files live in an external '../references/' bundle not present with this skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — tables for routing, JSON consumption, and re-entry rules; exact field names ('meta.yaml.implement_rounds.completed'); hard limits ('最多 3 个 round'); and no explanation of concepts Claude already knows. Not score 5 because there is minor duplication: the retry/rollback rules stated in '执行流程' are restated in the '可重入约定' table and repeated '严禁' notes, which could be consolidated. | 4 / 5 |
Actionability | Mostly executable guidance: exact agent routing per tech_type, precise meta.yaml mutations, a copy-paste rollback snippet ('BASELINE=$(yq ...); git checkout "${BASELINE}" -- ...; git clean -fd ...'), explicit forbidden commands, and a three-way fail decision table. Not score 5 because the core mechanism (SUBAGENT_PROMPT rendering) and validation chain live in an external template file ('subagent-prompt-template.md §2.5') that is not in this bundle, leaving minor gaps a reader cannot resolve from the body alone. | 4 / 5 |
Workflow Clarity | The multi-step process is clearly sequenced (preconditions → inputs → routing → fullstack rounds → consume result JSON → retry/rollback/terminate → status update) with explicit validation checkpoints: round-count guard ('completed = 2:...不应再次进入'), self-check + test runs required in the subagent, Code scope whitelist verification ('校验 Code scope 白名单未被意外缩窄'), and a 3-round cap that forces escalation. Feedback loops for error recovery (retry in place → escalate to rollback re-entry with path-level git restore) are explicit, and the destructive git operations carry explicit guardrails — matching anchor 5. | 5 / 5 |
Progressive Disclosure | Good structure: orchestration-level content stays inline, all six external references are one level deep and consolidated in a dedicated '参考资料' section with clear section-level pointers (§2.5, §3, §1.3), and nothing that belongs in a separate file is inlined. Not score 5 because the references point to '../references/' outside this skill's bundle — no references/ directory exists in the skill — so the referenced files cannot be verified from the skill itself, a minor organization gap; not score 3 because the structure and navigation are otherwise clear and well-signaled. | 4 / 5 |
Total | 17 / 20 Passed |