Content
78%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.
Well-structured content with a clear sequenced workflow, concrete command forms, and excellent progressive disclosure into real reference files. The main weakness is repeated restatement of the delegation/no-token constraints across sections, which could be consolidated for token efficiency.
Suggestions
Consolidate the '委托 ontology-core / 无须 token / Never 直接执行 CLI' reminders into a single stated-once constraint block to reduce repetition across 调用方式, 子技能依赖, 委托命令形态, 与 smart-data-analysis 的关系, and 配置 sections.
Surface a brief explicit validate→proceed checkpoint inline in the 主流程 checklist (e.g. '未拿到 meta_table_name → 回 step 2.4 补齐') rather than only in references/sql-execute.md, so the gating loop is visible without following a link.
Tighten the 步骤约束 summary and 注意事项, which partially overlap (e.g. no-fabrication rules appear in both '总结' constraint #7 area and the 注意事项 list).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and information-rich, assuming domain competence, but the delegation model ('Never 直接执行 ontology CLI', '无须 token', '委托 ontology-core') is restated across several sections and could be trimmed. | 4 / 5 |
Actionability | Provides concrete command forms — 'bkn object-type list <kn-id>', 'dataview query <dataview-id> --sql "..."', 'ontology --user-id <accountId> <command>' — and a copyable step checklist; placeholders are appropriate given the delegation model, with only minor gaps. | 4 / 5 |
Workflow Clarity | Clear 5-step sequence with a progress checklist, explicit 3a/3b routing, and gating constraints ('Schema 发现先于取数', '禁止混用', '只允许 SELECT/WITH'); the detailed validate→fix→retry loop lives in references rather than the body, leaving minor checkpoint gaps. | 4 / 5 |
Progressive Disclosure | Body is an orchestration overview that maps each step to a one-level-deep reference (kn-resolve.md, schema-discovery.md, sql-execute.md, tool-examples.md), all of which exist and are clearly signaled in a '必读 references' table. | 5 / 5 |
Total | 17 / 20 Passed |