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.
A dense, highly operational routing document: every command is concrete and executable, workflows are sequenced with pervasive validation gates and explicit error-recovery paths, and on-demand references are clearly organized. The weaknesses are minor: some rule text is duplicated between the contract and Shortcuts sections, and one reference points outside the skill bundle.
Suggestions
De-duplicate the Schema/Help fallback rules between the 最小 DWS 执行契约 block and the Shortcuts section — state the rule once and reference it from the other location.
Resolve the cross-skill link in references/lite-recipes.md (../../dingtalk-doc/references/doc/doc-import.md) — either verify the target exists in the deployed environment or inline the needed import steps.
Consider moving detail-level result semantics (e.g. the 成员/分页 field-by-field rules) into the existing references to slim the top-level SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic and assumes Claude's competence — no concept explanations, no padding; nearly every line is an operational constraint. Not 5 because the Schema/Help fallback rules are stated nearly verbatim twice (the 最小 DWS 执行契约 block and the Shortcuts section both repeat 'Schema 不可用才读一次已知 leaf Help;unknown flag 用同 leaf Help 修正一次…禁全 Catalog'), and 当前最短路径 partially re-derives Golden Route rows; these duplications could be trimmed. | 4 / 5 |
Actionability | Commands are copy-paste ready with concrete flags, placeholders, and expected result fields: 'dws wiki +space-list --type <orgWikiSpace|myWikiSpace> --limit 50 --page-all', 'dws wiki permission set-share-scope --workspace <ID> --visibility <PRIVATE|ORGANIZATION|PUBLIC>', and the schema introspection command with a full --jq expression. Parameter bounds (成员 --limit 默认 30 范围 1-50, --users 1-30) and validation fields (autoPageComplete, spaceTypeVerified, requestedType) make the guidance fully executable across the common cases. | 5 / 5 |
Workflow Clarity | Multi-step flows are explicitly sequenced with ordering bans ('+space-create → doc +import --workspace → +move-to-drive', 任何一步都不得在个人域提前创建), validation checkpoints gate every write (spaceTypeVerified=true 才可断言类型, 写后验证结果不凭退出码宣称成功, autoPageComplete=true 才可用列表缺席证明不存在), destructive operations require confirmation and ownership checks, and the 错误最短路径 section provides an explicit error-recovery feedback loop. This matches the 5 anchor's validate-fix-retry structure. | 5 / 5 |
Progressive Disclosure | The 按需加载 section is a well-signaled trigger-condition table mapping to five references that all exist and are one level deep, with an explicit policy ('Golden Route 参数足够时不读 reference;否则最多读取一个'). Not 5 because dense semantic rule sections (关键结果语义, 当前最短路径) are fully inlined where a stricter split would move detail to references, and references/lite-recipes.md links cross-skill to ../../dingtalk-doc/references/doc/doc-import.md, a path outside this skill's bundle. | 4 / 5 |
Total | 18 / 20 Passed |