Content
73%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 extremely thorough, highly actionable workflow with exemplary validation and recovery loops, undermined by systematic internal repetition — the grep-trap and anti-KPI rules are each restated many times, and war-story parentheticals pad nearly every section, ironically violating the skill's own single-source-of-truth principles. The reference bundle is genuine and well-signaled, but the main file carries far more than an overview should.
Suggestions
Consolidate the grep-vs-python-substring verification trap (currently fully explained in Step 4, 反模式 6, 反模式 9, and 5.0) into one canonical statement plus short pointers, and move the war-story anecdotes (案例 15/16/19 parentheticals) into progressive_disclosure_principles.md where the case studies already live.
Reduce the 'line count is not a KPI' rule, which is restated in the 铁律, 触发即 reframe, 反模式 1, 反模式 5, 5c, and the checklist, to one canonical section plus brief cross-references, freeing substantial tokens without losing the rule.
Move the detailed payload/shell-trap and probe material inline in the body (e.g., the codex jq command block and symlink rules) into verification-recipes.md with a trigger-condition pointer, keeping SKILL.md closer to the decision-and-entry-point overview the skill itself prescribes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~550-line body repeats the same guidance many times: the grep-vs-python-substring verification trap is fully explained at least four times (Step 4 硬 gate, 反模式 6, 反模式 9, 5.0 guidance), the 'line count is not a KPI' rule is restated in 铁律, 触发即 reframe, 反模式 1, 反模式 5, 5c, and the final checklist, and parenthetical war-story anecdotes (「实战:...案例 15/16/19」) pad many sections. This matches the anchor for noticeably verbose with several padded/unnecessarily repeated sections; it is above the 'extensively explains concepts Claude already knows' level because the material is domain-specific and mostly non-obvious, and below the 'mostly efficient with only minor trimming needed' level because the duplication is systematic rather than incidental. | 2 / 5 |
Actionability | The body gives fully executable, copy-paste-ready guidance throughout: exact commands (`codex debug prompt-input 'startup-instruction-audit' | jq ...`), concrete code (`Path("orig").read_bytes() in Path("target").read_bytes()`), script invocations with operational warnings (`scripts/sink_sections.py`, `profile_claude_md.py`, including that it has no dry-run), copyable citation formats, and naming conventions (`docs/references/{主题}-sop.md`). This matches the top anchor of fully executable, copy-paste-ready commands covering the common cases. | 5 / 5 |
Workflow Clarity | A clearly sequenced 5-step workflow (baseline → measurement/triage/layering → reference creation → L1 update → verification 5a/5b/5c) with explicit validation checkpoints (pre-write pointer gate, byte-level integrity checks, calibrated-criteria requirement), error-recovery feedback loops (verification failure restores the source file; re-run prohibited after mid-I/O failure to avoid duplicate appends), and a final checklist. This matches the anchor for a clear sequence with explicit validation, recovery loops, and a checklist; the batch/destructive-operation validation cap does not apply because validation is pervasive. | 5 / 5 |
Progressive Disclosure | The bundle is real and well-wired: both references exist and contain the cited appendices A-D and case studies, all three scripts are referenced from the body, and pointers are one level deep with explicit trigger conditions (「何时读」/触发场景) — matching the good-structure anchor with mostly appropriate placement and clear references. It falls short of the top anchor because the SKILL.md itself is a dense 550-line methodology rather than a lean overview; significant case-driven and verification-detail material arguably belongs in the already-existing reference files, especially given the skill's own anti-duplication doctrine. | 4 / 5 |
Total | 16 / 20 Passed |