Content
85%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.
A well-engineered methodology skill body: explicit sequence, validation gates, feedback loops, and an output contract make it highly actionable despite having no code. The weaknesses are a dangling reference to a nonexistent examples/ directory, a monolithic layout, and a trimmable table mapping to frameworks Claude already knows.
Suggestions
Create the referenced examples/ directory (or remove the '相关示例见 examples/' line) — the body's only external reference currently points at a nonexistent path.
Move the '与经典方法论的关系' comparison table and the empirical 约定层 case evidence into a one-level-deep reference file (e.g., references/methodology-mapping.md) and link it from the body, slimming SKILL.md toward an overview.
Consolidate the 约定层不执行 argument, which currently appears in step 2, step 5, and the core principles, into the step-5 constraint-layering table plus a single principle statement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with almost no filler ('没有数字的"问题"是感觉。', '改动落地 ≠ 已生效。'), but the '与经典方法论的关系' table (DMAIC/丰田/PDCA mapping) explains frameworks Claude already knows, and the 约定层 point is repeated across steps 2, 5, and the core-principles section. Efficient overall with minor trimmable over-explanation; not 5, but well above the padded verbosity of anchor 3. | 4 / 5 |
Actionability | For an instruction-only, domain-agnostic methodology the guidance is maximally concrete: judgment questions ('约束存在吗?存在但没执行吗?为什么没执行——是不知道、忘了、还是没法强制?'), decision tables with criteria, session-aware gate rules ('决策方在场→必须展示并等待确认…高风险改动仍须停下等待人工确认'), and a literal copy-paste 输出契约 template. Per the rubric's scoring note, absence of code in an instruction-only skill is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | Nine explicitly numbered steps (0–9) with validation checkpoints at every risky point: the step-6 decision gate, step-7 '跑完相关检查…全部通过才算实施完成', the step-8 三件套 (物证/加载/行为), and an explicit error-recovery loop ('若未改进,回到第 2 步重新找根因') plus the 输出契约 checklist. This matches the top anchor's clear sequence + explicit validation + feedback loops + checklist. | 5 / 5 |
Progressive Disclosure | Sections are clearly organized, but the body is a ~160-line monolith and its only external pointer is broken: '相关示例见 `examples/`' refers to a path that does not exist in the bundle (no examples/, references/, scripts/, or assets/ directories are present). The classic-methodology comparison table and empirical case notes are inlined content that could live in a separate file. Not anchor 4 because the sole reference is dangling and content that should be separate is inline; not anchor 2 because structure and signaling are otherwise good. | 3 / 5 |
Total | 17 / 20 Passed |