Content
92%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 excellent instruction-only skill body: lean, highly actionable, with a well-sequenced workflow that includes a self-check feedback loop and correctly delegated detail to four real, clearly-signaled reference templates. The only trim opportunity is the per-role contract section that previews reference-template content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — tables, checklists, and terse directives like '不给"较快"' with no concept explanations — but the '文档与下游的契约' per-role subsections preview data-model/interface/state-machine content already covered in feature-design-template.md, minor over-explanation that could be trimmed. Fits the 'efficient with minor trimmable instances' anchor rather than the every-token-earns-its-place of 5. | 4 / 5 |
Actionability | Fully concrete guidance for an instruction-only skill: exact save paths ('markdown/<topic>-feature-design-<YYYYMMDD>.md'), Given/When/Then requirements with concrete numeric examples ('p99 ≤ 200ms、错误率 < 0.1%'), enumerated boundary inputs ('0、最大值、Unicode、SQL 注入字符、超长字符串'), and an explicit stop condition ('如果输入没有 PRD,先停下来问用户要 PRD'). | 5 / 5 |
Workflow Clarity | A clear 6-step sequence with an explicit validation step ('自检' with a 10-item checklist) and a feedback loop ('如果任一项不过,补完后再交付'), plus an upfront guard for missing input. Matches the anchor for clear sequence with explicit validation and error-recovery loops; step 4's sub-gaps are covered by the reference templates. | 5 / 5 |
Progressive Disclosure | SKILL.md serves as a lean overview and all four referenced files (feature-design-template.md, api-spec-template.md, state-machine-template.md, test-matrix-template.md) exist in references/, are one level deep, and are clearly signaled with a purpose line and an explicit use-when ('深化"对外接口"章节时使用'). Matches the well-signaled one-level-deep anchor. | 5 / 5 |
Total | 19 / 20 Passed |