Content
85%Reviews 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 and well-structured with clear workflows and validation for destructive operations, supported by a clean one-level reference split. Its only weakness is redundancy of the dept+bot/--as-user safety guidance across several sections, which slightly hurts token efficiency.
Suggestions
Consolidate the dept+bot restriction and '--as user' guidance into a single authoritative section and cross-reference it elsewhere instead of restating the same constraints in the blockquote, 身份选择, 成员添加流程, and 快速决策 sections.
Tighten the repeated '不要把 wiki URL/名称直接当 --space-id' guidance, which appears in both 快速决策 and the delete-space 反例, into one statement to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence with no concept padding, but the dept+bot restriction and '--as user' guidance recur across the blockquote, 身份选择, 成员添加流程, and 快速决策 sections, so it could be tightened; it sits at the mostly-efficient-with-some-redundancy level rather than the fully lean level 3. | 2 / 3 |
Actionability | Provides copy-paste-ready commands with exact flags and JSON params (e.g. `lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'`, `lark-cli contact +search-user --query "..." --format json`) plus explicit fallback chains, matching the fully-executable anchor rather than the pseudocode level 2. | 3 / 3 |
Workflow Clarity | Destructive flows are clearly sequenced with explicit validation checkpoints — the delete-space path parses the ID, stops pagination on first exact match, mandates listing candidates for user confirmation before delete, and requires '--yes'; error hints distinguish retryable rate_limit from fix-and-stop cases, satisfying the explicit-checkpoints anchor. | 3 / 3 |
Progressive Disclosure | A shortcuts table signals one-level-deep references to references/*.md for each +verb, all 13 referenced files exist in references/, and detailed per-operation content is split out while decision logic stays inline, matching the clear-overview-with-well-signaled-references anchor. | 3 / 3 |
Total | 11 / 12 Passed |