Content
86%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.
Well-structured, token-efficient routing skill: concrete commands, sharp routing and boundary rules, real one-level-deep references, and explicit error-recovery guidance. The small deductions are for slight redundancy around +patch semantics and the absence of an explicit post-write verification checkpoint.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is tight and assumes competence — decision rules, flag semantics, and an executable regex-escaping example with no concept explanations. Minor trimming is possible: the '+patch' internal semantics are explained twice ("先完整下载 Markdown,再本地替换,再整文件覆盖上传" followed by "不是服务端原子 patch;它是 CLI 侧编排出来的局部更新能力") and the empty-file rule carries a justification ("因为 Drive 不支持零字节 Markdown,且空文件通常是误操作") that could be dropped. Fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the fully lean anchor 5. | 4 / 5 |
Actionability | Every decision line maps to a concrete command with correct flags ("lark-cli markdown +create --folder-token" vs "--wiki-token", URL normalization), and the regex example is copy-paste ready with BAD/GOOD variants. 'Fully executable; copy-paste ready commands; specific examples cover the common cases' matches anchor 5; there are no pseudocode or missing key details. | 5 / 5 |
Workflow Clarity | The flow is well sequenced — read lark-shared first (MUST), choose identity with auth step, route to a shortcut, and explicit error-triage checkpoints distinguishing stop conditions ("missing scope... 默认停止重试并按报错 hint 处理") from retryable ones ("只有 rate_limit、server_error... 才做有限退避重试"). It falls short of anchor 5 because there is no post-write verification step (e.g., fetch/diff to confirm the result) and patch/overwrite validation detail is deferred to references rather than stated as a checkpoint here. | 4 / 5 |
Progressive Disclosure | The body is a clean overview: a shortcut table links each verb to a real one-level-deep reference file (all five references/lark-markdown-*.md files exist and match their descriptions), and cross-skill links to lark-shared and lark-drive are clearly signaled in a dedicated 参考 section. 'Clear overview with well-signaled one-level-deep references; easy navigation' matches anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |