Content
75%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 compact, well-structured workflow with concrete subcommands, mandatory validation gates, and clear one-level reference navigation. It is held back from top marks by abstractly described validation loops, an unresolved root README.md reference, and some inlineable density.
Suggestions
Make the validate→fix→retry feedback loop explicit as concrete commands (e.g., run diagnose, review Tier2 output, fix, re-run) for the destructive write path to lift workflow_clarity.
Resolve the root README.md reference: either add a top-level README.md or point to scripts/README.md / assets/README.md so navigation links are not broken.
Move the dense process narration (steps 1-6 and the bullet list) into a referenced reference file, keeping SKILL.md as a leaner overview, to improve progressive_disclosure and conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, terse prose that assumes Claude's competence and avoids explaining LaTeX/NSFC basics; a few constraint sections could be tightened further, placing it just below the lean anchor. | 4 / 5 |
Actionability | Provides concrete executable commands (scripts/run.py preview, --dry-run, diagnose, coach, review, apply-section, diff, rollback --yes) and named reference files, with only minor gaps in full invocation examples. | 4 / 5 |
Workflow Clarity | Multi-step flow with explicit checkpoints (mandatory Tier2 review, backup-before-write, whitelist/bibkey gating, rollback entry, retry from last failed step); not quite a 5 because some validation feedback loops are described abstractly rather than as concrete validate→fix→retry commands. | 4 / 5 |
Progressive Disclosure | Well-organized into 流程/约束 sections with one-level-deep references to real files under references/; held below 5 because the body inlines substantial process detail and references a root README.md that is not present in the bundle. | 4 / 5 |
Total | 16 / 20 Passed |