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.
A well-organized, methodology-style body with concrete commands, a sequenced four-phase investigation, explicit validation feedback loops, and a useful common-mistakes table. Main weaknesses are broken external reference paths, minor time-sensitive clutter (dated lesson, port defaults), and actionability that leans on environment-specific terms an outside executor cannot act on.
Suggestions
Fix or inline the content from ../.cat-cafe-shared-refs/shared-rules.md §12/§16a and ../.cat-cafe-shared-refs/bug-diagnosis-capsule.md — the directory does not exist in the bundle context, so both links currently break navigation.
Move the dated incident citation (2026-04-05 runtime lesson) and environment-specific port defaults (3003/3004) into a clearly-labeled context or appendix section so time-sensitive details don't sit in the core guidance.
Give actionable fallbacks for environment-specific terms — search_evidence, 决策漏斗, Alpha 通道 — such as a brief description or a path to where they are defined, so the guidance is executable outside the home environment.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and imperative — it assumes Claude knows how to debug and never explains basic concepts — but contains minor trimmable material: the dated incident citation "来源:2026-04-05 runtime 状态误判教训" and environment-specific port defaults "`3003/3004` 默认是 runtime", which per guidelines count as time-sensitive clutter outside a deprecated/old-patterns section. Not anchor 5 for those tokens; not anchor 3 because the padding is minor, not a pattern of over-explanation. | 4 / 5 |
Actionability | Concrete, executable guidance is present: real commands (`lsof -nP -iTCP:<实际端口> -sTCP:LISTEN`, `ps -p <PID> -o lstart=`), a fill-in instance-forensics template, a concrete output path (`docs/bug-report/<bug-name>/bug-report.md`), and specific cross-skill handoffs (`tdd`, `writing-plans`, `quality-gate`). It falls short of anchor 5 because several directives depend on unverifiable environment context — "search_evidence", "决策漏斗", "Alpha 通道", "找合适伙伴" — that gives no actionable step outside that environment. | 4 / 5 |
Workflow Clarity | The four-phase investigation (根因调查 → 模式对比 → 假设实验 → 修复验证) is clearly sequenced with explicit validation in phase 4 ("确认 RED 真实覆盖问题…复验同一信号与受影响路径") and feedback loops ("出现新症状时回查机制", "结果不支持就更新假设"), plus a repeated-failure escalation section. Not anchor 5 because the sequence is deliberately optional ("可以…换方法") and hard requirements live in a separate unnumbered list, leaving the definitive workflow slightly diffuse; clearly above anchor 3 since checkpoints are explicit, not missing. | 4 / 5 |
Progressive Disclosure | The ~75-line body is well-sectioned with clear optional-vs-required separation, and its only external references — [../.cat-cafe-shared-refs/bug-diagnosis-capsule.md] and ../.cat-cafe-shared-refs/shared-rules.md §12/§16a — are one level deep and clearly signaled; no bundle files exist to organize. Not anchor 5 because the body exceeds the ~50-line simple-skill threshold and both referenced paths are broken (the shared-refs directory does not exist in the workspace), which breaks navigation; not anchor 3 because structure and reference signaling are otherwise good. | 4 / 5 |
Total | 16 / 20 Passed |