Content
62%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 offers a genuinely clear, well-sequenced workflow with strong validation gates and largely actionable, domain-specific guidance. Its weaknesses are verbosity (repeated rules and an inlined repo-policy paragraph with time-sensitive dates) and progressive disclosure: referenced refs/ files are absent from the bundle and heavyweight case policy is inlined in the overview file.
Suggestions
State the 'journey_validation is not a third delivery_lane' rule once (section 2) and let the Common Mistakes and Pressure Test tables reference it instead of restating it, trimming the body substantially.
Move the workspace/product-shell claim paragraph's checker and gate-policy details (runtime harness behavior, merge-gate policy, dates like 2026-09-10 and S2 #4669) into a dedicated reference file, keeping only the claim checklist inline; place dated policy changes under an 'old patterns/deprecated' heading.
Ship the referenced bundle files (refs/demo-contract-template.md, refs/falsifiable-technical-cutaway.md, refs/interaction-narrative-cases.md, refs/lessons-from-two-demos.md) with the skill so the one-level-deep reference structure is actually loadable, or inline the minimal needed content and drop the dead links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~310-line body is noticeably verbose: the 'journey is not a third delivery lane' rule is stated three times (section 2, Common Mistakes, Pressure Test), and the workspace-claim paragraph embeds repo-specific gate policy with time-sensitive dates ("2026-09-10 起,静态 prover 已被 runtime journey 取代", "S2 #4669 起") that are not in a deprecated section. It is not anchor 1 because nearly all content is genuine domain judgment knowledge rather than concepts Claude already knows. | 2 / 5 |
Actionability | Guidance is largely concrete and executable: named commands ("pnpm check:design-gate-real-interaction"), file paths ("packages/web/test/browser/", "docs/design-gate-claims/<id>.json"), deterministic verdict enums (SUPPORTED/REFUTED/UNKNOWN), and a stepwise sentinel-test checklist. It falls short of anchor 5 because some sections remain at judgment-rule level without executable specifics, but well above anchor 3's pseudocode-level guidance. | 4 / 5 |
Workflow Clarity | A clear numbered sequence (先路由 → §1 lock the judging question → §2 delivery lane → … → §6 Demo Contract → §7 build → §8 verification) with explicit validation checkpoints: the per-claim verification-mechanism table, the first-frame check, and the Pressure Test table with failure signals that gates entry into frontend implementation ("任一场景若无法从 Demo Contract 直接读出判题类型、交付车道、视觉真相源和诚实边界,不进入前端实现"). This matches anchor 5's clear sequence plus explicit validation steps, error-recovery feedback (Common Mistakes 修正 column), and checklists. | 5 / 5 |
Progressive Disclosure | References are clearly signaled one level deep ("refs/demo-contract-template.md", "refs/falsifiable-technical-cutaway.md", "refs/lessons-from-two-demos.md", "refs/interaction-narrative-cases.md") but none of these files exist in the provided bundle, so the links cannot be verified or loaded. Additionally, deep case policy (the workspace-claim checker/runtime-gate mechanics paragraph) is inlined in SKILL.md where it clearly belongs in a reference file. This fits anchor 3 — some structure, references present and signaled, but content that should be separate is inline — rather than anchor 2's minimal/buried structure or anchor 4's well-placed content. | 3 / 5 |
Total | 14 / 20 Passed |