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 well-engineered routing skill: every user intent maps to an exact dws command with flags, defaults, and safety gates, and validation/read-back semantics plus error-recovery loops are explicit throughout. The only real deductions are near-verbatim repetition of the Help/Schema fallback policy across three sections and a second hop of reference nesting beyond the ideal one-level-deep structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic and assumes competence — zero concept explanations, ~115 lines routing an entire product surface. It misses 5 because the Schema/Help fallback policy ('Schema 不可用才读一次 leaf Help；unknown flag 修正一次；unknown command 禁 Help') is restated nearly verbatim in the runtime contract, the Shortcut 发现 section, and error path #2. | 4 / 5 |
Actionability | Fully executable commands with flags, defaults, and conventions throughout: 'dws doc +create --name <标题> --content <文本|-|@文件> [--folder <ID>|--workspace <ID>]', "'-'=stdin，禁 '@-'", "'--role' 默认 READER (READER|DOWNLOADER|EDITOR|MANAGER)", covering ~20 common intents copy-paste ready, with a defined leaf-Schema fallback for unknown parameters. No anchor above fits better. | 5 / 5 |
Workflow Clarity | Explicit sequencing ('稳定 ID → shortcut → 局部读 → 精确写'), validation checkpoints everywhere ('写后验证结果，不凭退出码宣称成功', '回读匹配才报完成', '+export 有 localPath 且 sizeBytes>0 即终态'), and feedback loops for error recovery (REVISION_CONFLICT → re-read → diff → user confirm; 'partial_success 只补未完成'; 'doc_write_commit_unknown 先回读；禁止自动重试'). Destructive/batch writes all carry verification, so the missing-validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a lean routing layer with an explicit trigger→file table ('按需加载') that forbids preloading ('常规 +create、+fetch、+update... 禁止读取 reference；禁预加载/连读'), and all referenced files exist with bulk content appropriately pushed to references/doc/format/ and references/doc/style/. It is not 5 because references chain two hops (SKILL.md → doc-create.md → style/doc-create-workflow.md), and a few bundle files (doc-info.md, 04-document.md) are not reachable from the body's navigation table. | 4 / 5 |
Total | 18 / 20 Passed |