Content
92%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 an exemplary short skill: fully executable commands for every workflow, explicit failure-reporting rules, a verification/regression section, and a single real, clearly-signaled script reference. The only improvement space is trimming the slight redundancy between the opening, the path-hint blockquote, and the closing section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — concrete commands, no concept explanations Claude already knows, everything earns its place — but the path-hint blockquote and the closing "脚本是唯一入口" section partially repeat the opening instruction, minor trims possible. Not 5 due to that slight redundancy; not 3 because there is no unnecessary explanation or padding beyond it. | 4 / 5 |
Actionability | Every workflow is given as a copy-paste-ready command with real flags (--content, --grep, --full, --id, --stats, --project, --since/--until, --sort, --max) covering the common cases, plus fixed paths for the index and session files. Not 4 because the commands are complete and executable as written with no gaps. | 5 / 5 |
Workflow Clarity | The flow is clearly organized by use case (fast title search → slow body search → by-id → filters), with a 验证 section giving per-use checks and post-change regression steps, and explicit failure reporting ("搜索无匹配时报告'无匹配会话',不以空结果冒充成功;会话文件缺失时给出明确提示"). Operations are read-only, so the destructive-cap does not apply. Not 4 because validation and failure-feedback loops are explicitly present, not implicit. | 5 / 5 |
Progressive Disclosure | A short, well-sectioned overview with exactly one bundle file (scripts/find_session.py), which exists in the bundle and is linked clearly ("[find_session.py](scripts/find_session.py)") — a one-level-deep, well-signaled reference with everything else appropriately inline. Not 4 because there are no organization gaps or buried references. | 5 / 5 |
Total | 19 / 20 Passed |