Content
77%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 well-structured, highly actionable overview that delegates shortcut detail to one-level-deep references and provides validated multi-step workflows for capability discovery and task modification. Its main weakness is repetition across the search-tip blockquotes, which inflates token cost without adding new guidance.
Suggestions
Consolidate the three overlapping search-guidance blockquotes (任务搜索技巧, 任务清单搜索技巧, 意图区分补充) into a single rule about 'specified search skill vs. query keyword vs. range-only conditions', then give compact task/tasklist examples once each, to cut repetition.
Add one inline copy-paste example for the most common shortcut (e.g. +create minimal flags) so the highest-frequency action does not require opening a reference file.
Move the long permission table into a separate reference file (e.g. references/permissions.md) and keep only a pointer, reducing the overview's token footprint while preserving the detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content is high-value domain knowledge Claude would not know (API quirks, disambiguation, constraints), but the search-guidance blockquotes restate the same 'distinguish specified-search-skill vs. query-keyword' logic three times (tasks, tasklists, and the 补充 restatement), which could be tightened into one rule plus examples. | 3 / 5 |
Actionability | Provides concrete executable commands throughout ('lark-cli task --help', 'lark-cli schema task.tasklists.tasks', 'lark-cli task tasklists tasks --params "{...}" --as user') and a linked shortcut table; minor gap is that per-shortcut flag usage lives in the reference files rather than inline, which is appropriate but leaves a few common cases one hop away. | 4 / 5 |
Workflow Clarity | The 命令选择与渐进式发现 workflow is a clear 5-step sequence with explicit validation checkpoints and a feedback loop ('遇到 unknown_subcommand 时必须停止...回到第 2 步'), and the 从任务清单定位并修改任务的最短路径 gives another sequenced, validated path with a禁止客户端编号 guardrail. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview with a shortcut table linking to 18 one-level-deep reference files (all verified present in ./references/), plus cleanly separated API Resources and 权限表 sections; references are clearly signaled via markdown links and content is appropriately split. | 5 / 5 |
Total | 17 / 20 Passed |