Content
57%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 dense, highly actionable orchestration spec whose checklists, contracts, and command examples leave little ambiguity about what to do. Its main costs are repetition of the same governance rules, inlined reference material that belongs in separate files, and a missing validation gate before the destructive `metric delete -y` operation.
Suggestions
State the ontology-CLI delegation rule once (e.g., in the 职能矩阵) and remove the repeated declarations in the intro, 分工 table, and 注意事项; likewise fold 禁止交叉兜底 principle #6 into its dedicated section instead of stating it twice.
Add an explicit pre-deletion validation step to the 指标管理分支 checklist (e.g., require `ontology metric get <kn-id> <metric-id>` and user confirmation before `metric delete … -y`), which would also lift the workflow_clarity cap.
Move the metric command block and the detailed JSON/SQL examples into a local references/ file (one level deep, clearly signaled) instead of inlining them alongside the existing pointer to ../ontology-core/references/metric.md, and fix the two broken double-backtick code spans.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight domain-specific routing rules, but key rules are repeated many times: "Never 由本 skill 直接执行 ontology CLI" appears in the intro, the 分工 table, the 职能矩阵, and 注意事项 (4+ times), and 禁止交叉兜底 is stated both as 总入口原则 #6 and again verbatim in its own section. This is the 3 anchor (mostly efficient but could be tightened); not 4 because the repetition is substantial across a ~340-line body, not minor. | 3 / 5 |
Actionability | Concrete, near copy-paste-ready guidance throughout: the full `ontology --user-id <accountId> metric <subcommand>` command block, JSON body examples for `bkn object-type query` including the real InvalidParameter error case, and field-level handoff contract tables with 缺失处理 for every parameter. It falls short of 5 due to broken double-backtick markdown in two spots (``bkn object-type list`), and KN-id placeholders (`<填入KN id>`) that require manual fill-in before the core flow runs. | 4 / 5 |
Workflow Clarity | Sequencing is genuinely strong — the 5-step 编排总流程 plus per-branch checkbox lists (找表/指标管理/问数进度) with explicit stop conditions ("占位未填 → 告知用户并停止", "缺失则向用户索取,不得编造") and a dedicated failure-handling section. However the metric-management branch includes the destructive `ontology metric delete <kn-id> <metric-id> -y` with `-y` auto-confirm and no pre-deletion validation/verification step, which per the rubric's destructive-operation rule caps workflow_clarity at 3. | 3 / 5 |
Progressive Disclosure | The document is well-sectioned with headers, but there are no bundle files at all (no references/, scripts/, or assets/ in this skill), and content that clearly belongs in a reference file is inlined: the ~20-line metric command reference duplicates what is already pointed to at ../ontology-core/references/metric.md, and detailed SQL/JSON examples sit inline in an already ~340-line file. This matches the 3 anchor (some structure, content that should be separate is inline); not 4 because the bulk command reference inlining is more than a minor organization gap. | 3 / 5 |
Total | 13 / 20 Passed |