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 excellent operational skill body: fully executable commands, explicit routing priority with a golden-routes table, and strong validation/recovery discipline for writes and batch operations. The only notable flaws are a slightly repetitive schema-lookup paragraph and one orphaned reference file (references/recipes/conventions.md) that no document links to.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no explanation of concepts Claude already knows — every line is a routing rule, command, or constraint. Minor trimming is possible (the schema-lookup paragraph under Shortcuts reiterates Help-avoidance rules already stated in 执行契约), which fits anchor 4 rather than the fully lean anchor 5. | 4 / 5 |
Actionability | Every route is a copy-paste-ready command with concrete flags and placeholders (e.g. `dws todo +assign --to "张三" --task "<标题>" --format json`, `--priority 10|20|30|40`, `python scripts/todo_batch_create.py <todos.json> --dry-run`), with a full atomic-command skeleton table. This matches anchor 5 fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced (执行_contract read-first rule, numbered 路由优先级 1–5, Golden Routes intent table) with explicit validation checkpoints: mandatory post-write read-back verification ("写后必须核验"), reconciliation instead of blind replay for non-idempotent writes, and a dry-run planDigest confirmation gate for batch creation. Feedback loops for error recovery (unknown flag → Help once; unknown command → no Help, report drift) are present, matching anchor 5. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a clear overview with well-labeled, one-level-deep references (intent disambiguation, lite recipes, composite lifecycle, full command reference — all verified to exist) plus bundled scripts. However, `references/recipes/conventions.md` is an orphan: it is referenced nowhere in SKILL.md or the other reference files, so that content is not navigable from the skill entry point — a minor organization gap that fits anchor 4 rather than 5. | 4 / 5 |
Total | 18 / 20 Passed |