Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with well-sequenced SOPs and a clean progressive-disclosure structure pointing to real reference files. The only weakness is redundancy between the intent table, SOP-1, and the '高频硬约束' section, which inflates the token budget without adding new guidance.
Suggestions
Collapse '高频硬约束' into SOP-1 (or keep only the constraints not already stated there) to remove the near-duplicate rules on 完整保真, retry-once, contact handoff, multi-candidate, and --format json.
Trim the '意图表' to user-phrasing examples only and let the SOPs own the command mapping, avoiding re-stating the same triggers twice.
Merge the standalone '跨产品协作' bullets into SOP-1 step 4 (衔接), which already lists the same contact/chat/misc routing, to eliminate the second copy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and assumes Claude's competence, but '高频硬约束' largely restates SOP-1's rules (完整保真, 换维度重试一次, 切 contact 补详情, 多候选询问, --format json) and the '意图表' repeats the SOP triggers, so it could be tightened. Not level 1 (no concept explaining / padding) and not level 3 (redundancy means not every token earns its place). | 2 / 3 |
Actionability | Commands are concrete and copy-paste ready with explicit flags and dimensions — e.g. 'dws aisearch person --keyword "<完整值>" --dimension <维度> --format json' and 'dws contact user get --ids <userId> --format json' — matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | SOPs are numbered with '必须' markers, an explicit '失败' step (retry one dimension once, then 如实告知), multi-candidate handling, and a parse-then-act validation loop via --format json — matching the clear-sequence-with-checkpoints anchor. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview with well-signaled one-level-deep references — '[aisearch.md](references/aisearch.md)', intent-guide.md, lite-recipes.md, ding.md — all of which exist as real files; content is appropriately split, matching the top anchor. | 3 / 3 |
Total | 11 / 12 Passed |