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.
An exemplary router skill: a keyword-to-reference index with verified, well-signaled navigation, exact commands and flags, and explicit stop-and-confirm validation gates for the destructive whiteboard and Dev write workflows. The only cost is density — product-specific discipline (Dev mechanics, whiteboard gates) inlined in the router adds tokens on every invocation, and several routing rules are repeated across sections.
Suggestions
Move the Dev-specific mechanics (pagination fields, --json/--format flags, retry policy) out of SKILL.md into references/dev/ (e.g. a dev-conventions.md or the relevant dev/*.md), keeping only the dry-run→confirm→--yes gate in the router so non-Dev invocations don't pay that token cost.
Consolidate the no-pre-read rule, which is restated in the routing section, the attendance exception, the Dev, DevDoc and OA notes, into one routing-discipline statement; the whiteboard create/update gates could shrink to one-line rules pointing at whiteboard.md, which already carries the full flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational rules with zero concept explanations ("不做冷启动预读", "禁止批量预读或重复读取", "不要用 group help 探路") — every line is operative. However, the no-pre-read discipline is restated across the routing, attendance, Dev, DevDoc and OA sections, and deep product-specific mechanics sit inline in the router: Dev pagination details ("读取返回的 meta.pagination.endpoint_exhausted/next_token，续页传 --cursor <next_token>；禁止猜 --page、--page-num") and two long whiteboard gate paragraphs ("必须先执行 whiteboard render，展示 SVG 和渲染提示后停止…") that largely duplicate references/whiteboard.md. This is 'efficient with instances that could be trimmed' (score 4); not 5 because of the repeated rules and inline Dev/whiteboard depth, not 3 because nothing is padded or explains things Claude already knows. | 4 / 5 |
Actionability | Exact commands, flags, and file paths throughout: "dws dev app list --name" (with the explicit note "没有 dws dev app search"), "dws dev app robot get", "所有命令带 --format json", "connect list/status 还必须带它们自己的 --json", "把同一命令的 --dry-run 换成 --yes", "明确 STREAM 要传 --mode STREAM", "whiteboard render" / "whiteboard +diff", "dws whiteboard --node ... --part-id ...", plus exact per-intent reference paths in the product index table. Fully executable routing and discipline guidance, matching the copy-paste-ready anchor; per-product syntax is deliberately delegated to references with an explicit rule against guessing ("不要只凭索引推测命令"). | 5 / 5 |
Workflow Clarity | Multi-step flows are sequenced with explicit stop-and-confirm checkpoints and error-recovery loops. Whiteboard create: "必须先执行 whiteboard render，展示 SVG 和渲染提示后停止，等待用户明确确认当前版本才能创建；修改后重新渲染和确认". Whiteboard update: "必须先执行 whiteboard +diff，展示差异和风险后停止…再用同一 sourceDigest 执行 +update；diff 失败或有 blocker 时不得写入". Dev writes are gated by dry-run preview → explicit user confirmation → swap --dry-run for --yes → single post-write read-back, with a deliverables checklist ("执行前记下用户要求的每个交付项…最终逐项回答，空列表也明确写'暂无'") and retry discipline ("相同业务错误且参数、状态均未改变时不要重试；仅在新证据实际改变命令、参数或状态后重试一次"). This matches the validation-plus-feedback-loop anchor; the destructive-operation cap does not apply because validation is emphatically present. | 5 / 5 |
Progressive Disclosure | The body is a pure router: a keyword → "一句话范围" → "命令前缀" → exact reference path table (e.g. "先读核心 oa.md；发起审批再读 oa-create.md；附件操作再读 oa-attachments.md"), with every referenced file verified present in the bundle (references/ top level, dev/ 13 files, sheet/ 21, whiteboard/ 7, oa/ subdirs). Sub-references are stage-gated and explicitly signaled ("仅在进入对应阶段时再增量读取其 API 转换、映射、鉴权、表达式或故障定位子 reference，禁止一次性预读全集"; "每阶段最多一份、常规任务最多三份"). Clear overview, appropriately split content, easy navigation — matching the score-5 anchor; the second-level stage-gated chains (dev/mcp/*, sheet/*) are deliberate, explicitly governed extension, not buried content. | 5 / 5 |
Total | 19 / 20 Passed |