Content
81%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 tightly engineered orchestration skill: numbered phases with pervasive validation gates, retry/supersede feedback loops, concrete defaults and runnable scripts, and inline-linked reference files that all exist. Weaknesses are modest — some redundancy across the 校验/控制/约束 sections and a two-level-deep states/verifiers reference structure.
Suggestions
Consolidate the validation/gating rules repeated across 校验, 控制, and 约束 into a single section and cross-reference it, trimming roughly a screen of duplicated tokens.
Flatten the states/verifiers structure or inline a one-line-per-state summary table in SKILL.md so navigation stays one level deep (SKILL.md → STATE.md) instead of going through index.json files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is exceptionally dense: nearly every line carries non-obvious, domain-specific procedural detail (hash reconciliation, evidence-sufficiency gates, state-machine rules) and it never explains concepts Claude already knows — matching “efficient; minor instances of over-explanation”. Not a 5 because the 校验, 控制, and 约束 sections restate validation/gating rules several times, and the 輸出管理 rules partially duplicate the common-constraints block, so a small amount could be trimmed. | 4 / 5 |
Actionability | Concrete, executable guidance dominates: copy-paste-ready commands (validate_report.py / check_completion.py with flags), exact defaults (3 review rounds × 3 reviewers, max 3 parallel interpretations, 5–25 queries, 3–7 initial candidates), concrete paths, and per-step reference links. It stops short of anchor 5 because several orchestration steps invoke sibling skills (research-topic-extractor, research-literature-radar, parallel-vibe) without showing their invocation, and placeholders like {最终报告路径} leave small gaps for the common case. | 4 / 5 |
Workflow Clarity | Seven explicitly numbered phases with stop conditions and gates at each boundary (e.g., “未全量对账或 hash 漂移时停止”), an explicit feedback loop for recovery (phase_entry.py --mode retry superseding the attempt, re-running novelty checks after hypothesis rewrites), a dedicated 失败与恢复 section, and a final completion checklist (required Verifier + BSK Gate + completed status + check script). This matches anchor 5's “explicit validation steps; feedback loops for error recovery; checklists for complex processes”; anchor 4's “minor validation gaps” does not apply — validation is pervasive. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a genuine overview: five top-level guides in references/ are linked inline at their point of use (runtime-guide, research-synthesis, report-template, novelty-check, agent-review-prompt — all real files), scripts are listed and referenced, and sections are well organized. It misses anchor 5 because states/index.json and verifiers/index.json introduce a second reference level (SKILL.md → index.json → states/<state>/STATE.md), which the rubric counts as 2+ levels of nesting rather than the “one-level-deep references” the top anchor requires. | 4 / 5 |
Total | 17 / 20 Passed |