Content
77%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-structured orchestration skill: the two-step retrieval workflow is unambiguous with checklists and explicit fallback behavior, and detail is correctly pushed to three clearly-signaled, one-level-deep reference files. The main weakness is redundancy — the delegation-to-ontology-core and no-token rules are repeated many times in both the body and every reference file, which costs tokens without adding information.
Suggestions
State the CLI-delegation rule once in a prominent callout and remove the repeated 「Never 直接执行」 restatements from the intro, the dependency table, and the 与 smart-data-analysis 的关系 section.
Consolidate the no-token/gateway notes (currently in both 委托命令形态 and 与 smart-data-analysis 的关系) into the single delegation callout or the runtime_contract pointer.
Inline one minimal complete condition-json example in the body so the primary command form is copy-paste ready without opening metadata-search.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific constraints rather than concepts Claude already knows, but the same rule — 「Never 由本 skill 直接执行 ontology CLI,委托 ontology-core」 — is restated at least five times (intro, 调用方式, 子技能依赖 table, 委托命令形态 section, and again in 与 smart-data-analysis 的关系), and the no-token/gateway note appears twice. It fits the 'mostly efficient but could be tightened' anchor rather than the 'minor instances' of the 4 anchor. | 3 / 5 |
Actionability | Concrete command forms are given (`ontology --user-id <accountId> bkn object-type query <kn_id> <ot-id> '<condition-json>' [--limit n]`, `bkn object-type list <kn-id>`) plus explicit search/condition/limit rules and a full worked example deferred to references/tool-examples.md with a real condition-json. It is not a 5 because the body itself only carries placeholder templates; fully copy-paste-ready invocations require the reader to assemble pieces from the reference files. | 4 / 5 |
Workflow Clarity | The sequence is fixed and explicit (metadata KN query → duty KN query derived from step-1 clues → summary), with a copyable progress checklist, and explicit error-recovery/feedback paths: 空结果 → 「放宽 search / 换 KN / 二次澄清」, 命中过少 → rewrite search or loosen condition, 过宽 → lower limit, no clues → 简要反问, missing duty_kn_id → skip and note in summary. This matches the 5 anchor (checklist + feedback loops for recovery) and clearly exceeds the 4 anchor's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | The body is a true overview: a per-step reference table clearly signals [references/metadata-search.md], [references/duty-search.md], and [references/tool-examples.md] (all real files), config.json is pointed to for the pipeline/runtime contract, and the references are one level deep with no nested indirection (verified: they only cross-link sibling skills). This matches the 5 anchor's well-signaled, one-level-deep structure. | 5 / 5 |
Total | 17 / 20 Passed |