Content
67%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.
A dense, command-rich CLI skill body with strong routing, safety-confirmation, and error-recovery workflows plus a well-organized, verified reference tree. Its main weaknesses are rule redundancy across sections, an overloaded ~48KB overview that should shed detail into references, and a nearly impenetrable AI 表格 policy section.
Suggestions
Consolidate the AI 表格 MUST-DO bullets (lines 23–30) into a single sequenced checklist in references/products/aitable.md, keeping one short rule per concern in SKILL.md — link-fidelity rules are currently restated across four separate bullets.
Merge the three shortcut-guidance sections (使用原则, Shortcut 总览, 命令发现) into one, retaining the statistics table; the same selection rules ('不要为已知意图加载完整产品 Catalog') currently appear in multiple forms.
Move the Schema 字段速查 and --all/--compact boundary detail into a reference file (e.g. global-reference.md) and keep only the 4-layer progressive query ladder inline, shrinking SKILL.md toward a true overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and never explains concepts Claude already knows, but at ~48KB it restates the same rules repeatedly — link-fidelity/percent-encoding rules recur across the AI 表格 bullets ('逐字符比对', '%3D 不改为 %3d'), and shortcut-selection guidance appears in three separate sections (使用原则, Shortcut 总览, 命令发现). Mostly efficient but needs tightening, so 3 rather than 4, where redundancy would be only minor. | 3 / 5 |
Actionability | Concrete copy-paste-ready commands are plentiful ('dws schema "calendar event create" --compact', 'dws auth login --intl', 'dws event consume user_card_action_triggered --flatten -f ndjson') and protocols cite exact JSON fields ('error.reason == "confirmation_required"'). Falls short of 5 because common business operations are delegated to references and many invocations remain placeholders ('dws <service> +<verb> ...'). | 4 / 5 |
Workflow Clarity | Core flows are clearly sequenced with explicit validation checkpoints: the 4-step intent flow (URL 预检 → 意图分类 → 歧义处理 → 产品映射), the 3-step confirmation flow, the confirmation_required retry protocol, and the whiteboard render→confirm and +diff→confirm loops with sourceDigest. Not 5 because the AI 表格 delivery/link rules (lines 24–30) form an unsequenced policy tangle around one of the most-used products (140 shortcuts). | 4 / 5 |
Progressive Disclosure | Navigation is strong: a product table linking each product to its reference file, a '详细参考 (按需读取)' index with one-line descriptions, an explicit read-on-demand principle ('只读相关段落,不预加载全篇'), and all referenced files verified to exist. Not 5 because the overview itself carries large blocks (命令发现/Schema 字段速查, the AI 表格 policy wall, Shortcut 总览) that belong in reference files. | 4 / 5 |
Total | 15 / 20 Passed |