Content
81%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 well-engineered operational skill body: executable commands, explicit routing arbitration, minimal-first-information principles, and a real error-recovery decision tree. The main costs are redundant restatements of the routing and retry rules, and the initiate flow's two critical parameter references being buried one level below the top-level table.
Suggestions
State the routing rule (审批待办不是飞书任务 + the action-verb list) once instead of twice in the 路由优先级 section; the 判定规则 paragraph largely repeats the preceding bullet list.
Surface lark-approval-instance-form-control-parameters.md and lark-approval-instance-value-sourcing.md in the SKILL.md table (e.g., on the instances create row) so the create flow's mandatory references are visible at the top level.
Merge the duplicate retry guidance: 执行原则 §3 and the 1395001 section both say '最多重试1次' — keep the number in one place and cross-reference it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense routing table plus decision rules with essentially no padding or explanation of known concepts. It falls short of 5 because there is noticeable duplication: "审批待办不是飞书任务" is stated twice (routing header and 判定规则), the action list 同意/拒绝/转交/退回/撤回/催办/加签/抄送 is enumerated twice within the same routing section, and "最多重试1次" is repeated between 执行原则 §3 and the 1395001 section. | 4 / 5 |
Actionability | Highly concrete: a 14-row command mapping table, a bash block with real CLI invocations, topic enum codes (1待办 2已办 17未读 18已读), and the exact 1395001 error-code decision tree. It is not 5 because the flagship complex operation — instances create — shows "form":"[...]" in the example, which is a placeholder rather than usable syntax and delegates the hard part entirely to the reference; minor gaps remain for a first-time reader. | 4 / 5 |
Workflow Clarity | Both processing chains are explicitly sequenced (发起审批: search → get → create; 处理审批: query → optional get → operate) with the precondition rule that operations must carry instance_code + task_id as a pair. Error recovery is a genuine feedback loop: the 1395001 decision tree stops blind retries, permits exactly one re-query, and ends with a required user-facing conclusion — matching the 5 anchor's 'explicit validation steps; feedback loops for error recovery'. | 5 / 5 |
Progressive Disclosure | The body is a clean overview: a per-command table where every row links a verified reference file, with all 14 linked files present in references/. It is not 5 because two reference files that the body itself calls critical for the create workflow (lark-approval-instance-form-control-parameters.md, lark-approval-instance-value-sourcing.md) are not surfaced anywhere in SKILL.md — they are only discoverable via a second hop through initiate.md, and references cross-link each other, so navigation is two hops deep for the most complex flow. | 4 / 5 |
Total | 17 / 20 Passed |