Back to Details

kb

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

kb — bundles

kb — bundles

Hub for the 
kb-*
family: vocabulary, shared reference, routing. Knowledge compounds — compiled once, kept current, not re-derived per query. Does not modify a bundle — routes to the skill that does.
核心枢纽：
kb-*
系列技能的词汇表、共享参考库与路由中心。知识复合包——一次性编译，持续更新，无需每次查询重新生成。本技能不修改知识包，仅路由至对应修改技能。

Key terms

关键术语

references/glossary.md defines the vocabulary. Minimum before routing: Bundle, Ingest, Progressive disclosure, Trust model (see trust-model.md).
references/glossary.md 定义了相关词汇。路由前需了解的核心术语：Bundle（知识包）、Ingest（导入）、Progressive disclosure（渐进式披露）、Trust model（信任模型）（详见trust-model.md）。

The one hard rule

唯一硬性规则

A bundle is conformant iff every non-reserved 
.md
file has parseable YAML frontmatter with a non-empty 
type
. Everything else is soft guidance — consumers MUST tolerate missing optional fields, unknown types, and broken links. Never reject a bundle over them. Full rules: references/SPEC.md §11.
The domain portion of 
spec/types.md
is a living, producer-chosen vocabulary, not a validation enum. Keep the workflow conventions 
Reference
and 
Spec Section
; start the domain types small and evolve them through 
kb-ingest
 or 
kb-document
 when the domain reveals a durable new kind of entity. Use 
kb-lint
 to detect schema drift.
一个知识包若要合规，需满足：所有非保留的
.md
文件均包含可解析的YAML前置元数据，且其中
type
字段非空。其余均为软性指导——消费者必须兼容缺失的可选字段、未知类型与失效链接，绝不能因此拒绝知识包。完整规则详见：references/SPEC.md §11。
spec/types.md
的领域部分是由生产者自主选择的动态词汇表，而非验证枚举值。请保留
Reference
（参考文档）与
Spec Section
（规范章节）这两个工作流约定；初始领域类型应精简，当业务场景出现新的持久化实体时，通过
kb-ingest
或
kb-document
逐步扩展。使用
kb-lint
检测架构偏差。

Route to the right skill

路由至对应技能

The user wants to…Use
Start a new bundle
kb-init
Capture, ingest, file, or process a source (note, transcript, PDF, image, URL)
kb-ingest
Document a repository, explain its architecture/workflows, or refresh knowledge after code changes
kb-document
Ask what the bundle knows; look something up; explore connections
kb-query
Health-check the bundle (drift, orphans, contradictions, conformance)
kb-lint
See the bundle as a graph
kb-visualize
If a 
knowledge/
bundle exists and would inform the current task, consult it via 
kb-query
 before answering from scratch — even when the user didn't ask an explicit knowledge question.
用户需求适用技能
创建新的知识包
kb-init
捕获、导入、归档或处理数据源（笔记、转录文本、PDF、图片、URL）
kb-ingest
为仓库生成文档、解释其架构/工作流，或在代码变更后更新知识
kb-document
查询知识包内容、检索信息、探索关联
kb-query
检查知识包健康状态（偏差、孤立内容、矛盾点、合规性）
kb-lint
以图谱形式查看知识包
kb-visualize
若存在
knowledge/
知识包且可辅助当前任务，应先通过
kb-query
查询该包，再从零开始作答——即使用户未明确提出知识查询类问题。

Shared reference (single source of truth)

共享参考库（唯一事实来源）

Every 
kb-*
skill reads these rather than restating them, so the family stays consistent:
  • references/SPEC.md — OKF v0.2, vendored verbatim.
  • references/version-profile.md — v0.2 production and v0.1 compatibility rules; every writing skill reads it before changing a bundle.
  • references/glossary.md — leading words and definitions.
  • references/trust-model.md — the maintenance rules.
  • templates/ — 
    concept.md
    , 
    index.md
    , 
    log.md
    starters.
  • example-bundle/ — a tiny conformant bundle: a worked example, and the seed 
    kb-init
    copies from.
所有
kb-*
技能均读取以下资源，而非重复定义，以确保系列技能的一致性：
  • references/SPEC.md — OKF v0.2，原版引入。
  • references/version-profile.md — v0.2生产环境规则与v0.1兼容性规则；所有编辑类技能在修改知识包前均需读取此文档。
  • references/glossary.md — 核心词汇与定义。
  • references/trust-model.md — 维护规则。
  • templates/ — 
    concept.md
    、
    index.md
    、
    log.md
    模板文件。
  • example-bundle/ — 一个小型合规知识包：示例参考，也是
    kb-init
    技能复制的初始模板。