Content
82%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 strong operational skill document: concrete executable commands for every operation, correctly ordered workflows with safety rules (no empty-value overwrites, cancel-before-create), and accurate script references that all resolve to real bundle files. The main gaps are minor — no post-write validation for database operations, a version-dated note, and deployment-prefixed script paths.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational, focusing on system-specific facts Claude cannot know (identifier generation rules, the injected Sender block format, script semantics) rather than general concepts. Minor over-explanation exists — the peer derivation rules ("trim → 移除 ASCII 控制字符", NFKC caveats) run long, and the version-dated note "OpenClaw 2026.10.4 不读取 HEARTBEAT.md" is time-sensitive information not placed in a deprecated/old-patterns section. It is not a 5 because of these trimming opportunities, and not a 3 because nothing explained is generic knowledge. | 4 / 5 |
Actionability | Every operation has a complete, copy-paste-ready bash command with explicit placeholders tied to injected values (e.g. cs-update.sh with --peer/--purpose/--prompt-source, follow-up-create.sh with all five arguments), and the guidance covers semantics ("参数均为可选…脚本会自动忽略空值,不覆盖已有记录"), output format (tab-separated fields), and edge cases ("没有到期任务时输出 NO_DUE_TASKS 并正常退出"). This matches anchor 5: fully executable commands covering the common cases. | 5 / 5 |
Workflow Clarity | Sequences are explicit and ordered — "先调用 cs-update.sh 更新…再在下一个 turn 输出对客户的回复" and the two-step "第一步:取消…第二步:创建新任务" — with a documented status flow (pending → sent_once → completed) and error-handling rules ("脚本报错时按失败处理,不能当作无任务"). It is not a 5 because the database workflows lack a post-write verification step (e.g. confirming the record was updated or the task created), which the rubric flags as important for database operations. | 4 / 5 |
Progressive Disclosure | All seven scripts referenced in the body (cs-update.sh, follow-up-create/cancel-pending/expire/due/mark-sent/complete.sh) exist in the bundle's scripts/ directory, and the one external pointer (proactive-send SKILL.md「定时扫描到期跟进」) is clearly signaled and one level deep. Sections are well-organized with a sensible overview-to-detail progression. It is not a 5 because the script paths use the deployment prefix ./skills/customer-db/scripts/ rather than bundle-relative paths, and the field-dictionary section (二、字段含义) is reference material inlined in the main file. | 4 / 5 |
Total | 17 / 20 Passed |