Content
77%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 mature, well-architected operating manual: concrete CLI tooling, explicit validation checkpoints, per-failure-mode recovery procedures, and exemplary just-in-time reference loading. Its main weakness is token efficiency — boundary and safety rules are restated across sections and sentences are overloaded with conditions, which both costs tokens and obscures the sequence.
Suggestions
State each rule once: the 研究目标/技术路线 scope exclusion and the backup/rollback policy each appear in three sections — keep the authoritative version in 约束/输出管理 and reference it elsewhere.
Split the multi-clause policy sentences (e.g. 执行步骤 2 and 4, which stack 4–5 conditions each) into short bullet rules so each condition is independently checkable.
Add one complete example invocation with sample output for `preview --dry-run` (and the resulting diff format) so the common write path is copy-paste executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | There is no padding that explains concepts Claude already knows — every section is domain-specific policy — but the body repeats itself: the scope exclusion ("研究目标、技术路线…不属于本 Skill") appears in 目标, 执行步骤 3, and 专属约束; backup/rollback rules are stated in 输出管理, 校验, and 失败与恢复; and long multi-clause sentences stack overlapping conditions that could be split. It is not 4 because the redundancy is more than minor instances, and not 2 because there are no irrelevant explanations or padded sections. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: exact commands (`python skills/nsfc-justification-writer/scripts/run.py validate-config`, `preview --dry-run`, `rollback --project-root <项目目录> --run-id <run_id> --yes`, the test script invocation), real file paths, specific flags, and quantified rules (研究意义 2–3 段、15%–25%). It is not 5 because full invocation syntax for `preview`/`diagnose` is only implied (subcommand shown without the complete command line) and no worked example of a diff or output is included. | 4 / 5 |
Workflow Clarity | A six-step numbered sequence is followed by a dedicated 校验 section with runnable checks (validate-config → diagnose → preview --dry-run) and a 失败与恢复 section that enumerates failure modes with explicit recovery loops: reject write → fix → re-run preview; backup before every write; list-runs → rollback --yes for undo. Since writes modify user files, validation is present and explicit, so the missing-validation cap does not apply. It is not 4 because checkpoints and error-recovery feedback loops are explicit per failure mode, not merely present. | 5 / 5 |
Progressive Disclosure | Three references — [分节写法](references/section_writing.md), [质量控制](references/quality_control.md), [回归样例](references/regression_examples.md) — are one level deep, all verified to exist, and each is linked at its point of need with explicit load timing ("先按需读取…规划", "完成正文后读取…复核", "需要回归对照时读取"). The split is appropriate: the body holds orchestration and safety policy while the references hold the domain detail. It is not 4 because signaling, depth, and placement all match the top anchor with no buried or nested references. | 5 / 5 |
Total | 17 / 20 Passed |