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.
The body is a strong operational skill file: exact dws commands everywhere, SOPs with explicit triggers, disambiguation checkpoints, and error-recovery rules, with bulk detail correctly pushed into reference files. Its main weaknesses are mild — rule duplication between the SOPs and the 高频硬约束 section, and reference navigation spread across several locations instead of one consolidated map.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — shortcut tables, SOP steps with exact commands, and guardrails, with no explanation of concepts Claude already knows. It falls short of level 5 because of duplication: the "高频硬约束" section restates rules already given in SOP-1/SOP-2/SOP-3 (aisearch routing, search-mobile exception, batch disambiguation), and the Shortcuts preamble's schema-probing rules are heavily compressed but partially overlapping with the SOPs' command guidance. | 4 / 5 |
Actionability | Every instruction is a copy-paste-ready command with flags and placeholders, e.g. `dws contact user get --ids <userId1>,<userId2>,... --format json`, `dws contact user search-mobile --mobile "<完整手机号>" --format json`, and `python scripts/contact_dept_members.py --query "<部门名>"`, plus a 13-row shortcut table and schema-introspection command with exact --jq expressions. This matches the fully-executable, common-cases-covered anchor; level 4 would require minor gaps, and none are evident. | 5 / 5 |
Workflow Clarity | Each SOP has explicit triggers, strictly numbered steps, and feedback loops: ambiguous name matches "必须列候选请用户确认" (never default to the first), SOP-4 normalizes the `deptId=-1` sentinel to `deptId=1` before follow-up calls, and the Shortcuts section prescribes error recovery for `unknown flag`/`unknown command` (one Help retry, then drift reporting). These are read-only flows, so user-confirmation and sentinel normalization checkpoints satisfy the validation anchor; level 4 would require missing checkpoints, which is not the case. | 5 / 5 |
Progressive Disclosure | Structure is good: the 595-line command reference lives in references/contact.md, playbooks and disambiguation guides are in references/ (08-directory.md, intent-guide.md, lite-recipes.md), and all paths referenced in the body exist in the bundle. It stops short of level 5 because navigation is scattered across three places (the 前置条件 blockquote, the bottom 局部意图 section, and inside 08-directory.md, which is the only route to recipes/conventions.md, putting that file two hops from SKILL.md) rather than a consolidated, clearly-signaled reference map. | 4 / 5 |
Total | 18 / 20 Passed |