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.
An exceptionally actionable, densely operational skill body: every command is copy-paste ready, workflows carry explicit validation gates and error-recovery loops, and on-demand reference loading is systematically mapped to trigger conditions with all link targets verified to exist. The main costs are token-efficiency — several bullets are duplicated verbatim within the same sections and the form-share contract is spelled out twice — and a few specialized contract sections plus the unlinked scripts/ directory that keep the disclosure structure short of fully clean.
Suggestions
Remove the verbatim-duplicated bullets in 执行约束 and 记录稳定约束 (timestamp reuse, JSON-field reuse, TodoWrite thresholds, 回读/hasMore rules each appear twice) to cut tokens without losing any rule.
Move the specialized 表单分享用法回答契约 and 返回值评审专用查询 sections, including both full two-line answer transcripts, into references/aitable/aitable-form.md and keep only the routing rules and discovery gate in the body.
Link the published scripts by path (e.g. scripts/upload_attachment.py, scripts/import_records.py) where the body mentions them, so the upload/import entry points are discoverable instead of only alluded to.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body never explains concepts Claude already knows — every line is an operational rule, so it avoids the padding of the anchor-1/2 examples — but it is still not tight: the 执行约束 and 记录稳定约束 sections contain verbatim-duplicated bullets ("多个资源名要求同一时间戳时,只取一次并复用"、"复用 JSON 已返回字段,不以 --verbose/raw/pretty 重复请求"、"新增或更新只使用真实返回的 ID 回读…"、the TodoWrite rule and hasMore/partial_success rule each appear twice), and the two form-share answer transcripts are spelled out twice at full length. This fits 'mostly efficient but could be tightened' rather than 'noticeably verbose with padded explanations'. | 3 / 5 |
Actionability | Guidance is fully executable throughout: exact CLI invocations with all flags ("dws aitable +record-query --base-id <ID> --table-id <ID> [--record-ids <IDs>] [--field-ids <IDs>]…"), exact JSON payloads ("--tables '[{\"name\":\"<表名>\",\"fields\":[{\"fieldName\":\"<字段名>\",\"type\":\"text\"}]}]'", singleSelect config "{\"options\":[{\"name\":\"<选项>\"}]}"), and a copy-paste-ready two-line answer template with concrete ID examples. Commands cover the common cases comprehensively. | 5 / 5 |
Workflow Clarity | Multi-step flows are explicitly sequenced with validation checkpoints and feedback loops: the psql flow ("先用 -d <baseId> -l 发现逻辑表,再用 -t <tableId> 查看列类型,使用返回的 Name 执行 LIMIT 3 最小查询,成功后才以 -c <SQL> 执行正式只读查询"), write-then-verify ("写后按任务结果契约验证;不能仅凭退出码宣称成功" plus 读回 with real IDs), import-file confirmation gate ("首次调用先触发 Runtime 确认门禁,取得明确确认后由执行方追加 --yes"), invalid-cursor recovery, and the 错误最短路径 loop ("错误提供 actions/available_flags 时只按其中的 next_command 修正一次"). Destructive/batch operations all carry explicit validation, so the workflow-clarity cap does not apply. | 5 / 5 |
Progressive Disclosure | Structure is good: the body is a routing layer (Golden Route table, simple-leaf table, and a well-signaled 按需加载 trigger→reference table), and every referenced path (references/aitable/*.md, references/aitable-record-ops.md, references/aitable-section.md, references/intent-guide.md, references/aitable.md) exists one level deep in the bundle. Minor gaps keep it below anchor 5: the scripts in scripts/ are referenced only generically ("本 Skill 明确发布的脚本可编排 dws") with no path links, and the highly specialized 表单分享用法回答契约 and 返回值评审专用查询 sections with full example transcripts are inlined where aitable/aitable-form.md already exists as the natural home. | 4 / 5 |
Total | 17 / 20 Passed |