Content
50%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 well-organized as a routing entry point and encodes a coherent, sequenced design method with an explicit verification loop, but it operates almost entirely at the level of abstract principle. Its biggest concrete defect is bundle integrity: the routing table's four module targets are missing from the bundle and the assets/ files are orphaned, so the progressive-disclosure structure does not actually resolve for the skill's primary paths.
Suggestions
Ship (or correct the paths to) the four modules/*.md files referenced by the routing table — solution-design.md, role-behavior-coverage.md, app-experience.md, document-expression.md — so the skill's primary navigation path resolves.
Add one concrete artifact inline, e.g. a minimal instance of the shared checklist or a worked example of the 观察→问题/原因→目标→候选→机制→验证 chain, so the method is executable rather than purely principled.
Trim the version-check section and consolidate the boundary caveats (auto-triggering, authorization scope, missing-module handling) into a single statement each; also reference or remove the five unreferenced assets/*.md files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of concept-explaining padding, but it is not tight: the 20-line "read-only version check" section enumerates edge cases at length, and boundary caveats (don't auto-trigger reviews, don't gain new authorization, don't block on missing modules) are restated across 职责与协作, 按当前工作加载模块, and 混合交付. This matches level 3 (mostly efficient, some unnecessary explanation or could be tightened) better than level 4, where over-explanation would be only minor. | 3 / 5 |
Actionability | Concrete elements exist — the routing table maps task types to specific module files, and step 3 names a traceability chain ("观察及证据范围→问题/原因→目标与约束→候选及取舍→机制→可观察效果→验证") — but the guidance stays at the level of principles ("区分问题、原因与约束", "用证据限制结论") with no examples, checklist, or worked procedure inline. Operational detail is deferred to reference files, and the four primary module targets (modules/solution-design.md 等) do not exist in the bundle, so key execution details are effectively missing — squarely level 3 (some concrete guidance but incomplete, missing key details). | 3 / 5 |
Workflow Clarity | The 共同方法 section gives a clearly sequenced 5-step process ending in an explicit closed loop ("修订与验证形成闭环……只验证受影响范围"), so a sequence and verification intent are present. However, checkpoints remain abstract principles ("检查机制和依据是否表达完整") rather than executable steps, and the workflow's main continuation instruction — load the appropriate module from the routing table — points at files absent from the bundle, leaving gaps that fit level 3 rather than level 4. | 3 / 5 |
Progressive Disclosure | The SKILL.md is structured as an overview/router with one-level-deep, well-signaled links (all five cited references/*.md files exist, including fragment anchors), but scoring against the actual bundle reveals a broken main navigation path: the four modules/*.md files the routing table dispatches to do not exist, and the five assets/*.md files are never referenced from the body at all. Structure and signaling are better than level 2, but the missing primary targets are more than the "minor organization gaps" of level 4. | 3 / 5 |
Total | 12 / 20 Passed |