Content
88%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.
An exceptionally actionable routing skill: copy-paste commands with flags, pervasive validation and error-recovery checkpoints, and disciplined on-demand loading of real reference files. The main weaknesses are moderate duplication of the fallback/pagination rules across sections and a slightly imperfect one-level-deep reference structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with no concept explanations and full assumption of Claude's competence — every line is a constraint or a command. It is not 5 because the Schema/Help fallback ladder and the pagination stop conditions are each restated nearly verbatim in two to three sections (runtime contract, Shortcut 发现, 目标与完整性, 错误最短路径), which could be consolidated; it is well above the 'unnecessary explanation' level of 3. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands with flags cover the common cases: "dws minutes +search --scope all --query \"<关键词>\" --page-all", "dws minutes +detail --id <taskUuid> --artifacts basic,summary,keywords", "python3 <本Skill目录>/scripts/format_timestamp.py --unit ms --timezone Asia/Shanghai <时间戳1>", plus the concrete response fields to check (data.direction/data.complete/data.pages, meta.pagination). No gaps between instruction and execution. | 5 / 5 |
Workflow Clarity | Validation checkpoints are explicit and pervasive: "写后验证结果,不凭退出码宣称成功", "必须由 published/path/manifest/files 证明落盘", complete=true pagination verification, and resume handles "taskUuid/taskId/sessionId/checkpoint". Feedback loops are present (unknown flag → same-leaf Help → correct once; async timeout → --resume), and destructive/batch operations have confirmation gates and per-member ledgers, so the missing-validation cap does not apply. The Golden Route table functions as a checklist with per-route sequencing and boundaries. | 5 / 5 |
Progressive Disclosure | The skill is a clear routing overview with an explicit on-demand policy ("每个 Case 最多先读取一个最精确的文件") and a trigger-conditioned table pointing to real files (references/07-minutes.md, references/intent-guide.md, references/minutes.md, scripts/format_timestamp.py all exist in the bundle). It is not 5 because some content sits two levels deep from SKILL.md (references/minutes.md → references/recipes/conventions.md; intent-guide.md → 10/11 speaker files), and those second-level files plus lite-recipes.md are not surfaced in the SKILL.md loading table. | 4 / 5 |
Total | 18 / 20 Passed |