Content
71%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 well-structured and actionable with concrete CLI commands and an appropriate cross-skill reference for shared concerns, scoring strongly on progressive disclosure and actionability. Its main weakness is conciseness, where the auto-fill rule is redundantly restated.
Suggestions
Remove the redundant 注意 blockquote that restates the employee_type/user_ids rule already shown in the table and 填充示例 section.
Add one complete end-to-end example command (e.g., `lark-cli attendance user_tasks query --data '{"user_ids":[]}'`) to make guidance fully copy-paste ready.
Add a brief error-handling note (what to do if the schema shows unexpected fields or the API call fails) to close the workflow validation gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and free of concept-explanation padding, but the employee_type/user_ids auto-fill rule is restated three times (table, 填充示例, and the 注意 blockquote) and could be tightened, fitting 'mostly efficient but could be tightened'. | 3 / 5 |
Actionability | Concrete, real CLI commands are given (lark-cli schema ..., lark-cli attendance ...) with named resource/method (user_tasks.query) and required scope, but no full copy-paste end-to-end example is provided and the --data JSON uses a '...用户提供的参数' placeholder, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The sequence is clear (read lark-shared → run schema first → call API) with an explicit schema-first checkpoint; the missing error-recovery feedback loop is a minor validation gap, and the readonly query is not subject to the destructive/batch cap. | 4 / 5 |
Progressive Disclosure | This is a short (<50 lines), well-organized skill with a single clearly-signaled one-level-deep reference (CRITICAL link to ../lark-shared/SKILL.md) that appropriately delegates shared auth/permissions, meeting the simple-skill bar for a 5. | 5 / 5 |
Total | 16 / 20 Passed |