关于 kb
`kb-*` 技能系列的路由与参考中心,定义共用词汇和知识包规则。它将任务指向合适的技能,本身不修改知识包。
主要功能
- 01将任务路由到 `kb-*` 技能
- 02定义知识包共用词汇
- 03说明知识包符合性要求
- 04提供共用规范和模板
适用场景
- 01为知识包任务选择对应技能
- 02查看知识包符合性要求
- 03查找共用术语和参考资料
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ stjbrown/ agent-knowledge --skill kb安装后在 Claude Code 中输入/kb确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
example-bundle/index.mdlog.mdexample-bundle/concepts/customers.mdorders.mdexample-bundle/references/sample_sales_data.mdexample-bundle/spec/conventions.mdtypes.mdreferences/glossary.mdSPEC.mdtrust-model.mdversion-profile.mdtemplates/concept.mdindex.mdlog.md详细介绍
kb — 套件
kb-* 系列的中枢:词汇、共享参考资料、路由。知识会复合——编译一次、保持最新,而不是针对每次查询重新推导。不会修改套件,而是路由到负责修改的技能。
关键术语
references/glossary.md 定义了词汇。路由前至少要了解:套件、摄取、渐进式披露、信任模型(参见 trust-model.md)。
唯一的硬性规则
当且仅当每个非保留的 .md 文件都有可解析的 YAML frontmatter,且其中包含非空的 type,套件才符合规范。其他一切都是宽松指引——使用者 MUST 容忍缺少可选字段、未知类型和失效链接。绝不能因此拒绝套件。完整规则见:
references/SPEC.md §11。
spec/types.md 中的领域部分是一个持续演进、由生产者选择的词汇表,而不是用于验证的枚举。保留工作流约定 Reference 和 Spec Section;领域类型从少量开始,并在领域中显现出持久的新实体类型时,通过 kb-ingest 或
kb-document 逐步扩展。使用
kb-lint 检测架构漂移。
路由到合适的技能
| 用户想要…… | 使用 |
|---|---|
| 创建新套件 | kb-init |
| 捕获、摄取、归档或处理来源(笔记、转录、PDF、图像、URL) | kb-ingest |
| 记录代码库、解释其架构/工作流,或在代码更改后更新知识 | kb-document |
| 询问套件了解什么;查找信息;探索关联 | kb-query |
| 对套件进行健康检查(漂移、孤立项、矛盾、一致性) | kb-lint |
| 以图的形式查看套件 | kb-visualize |
如果存在 knowledge/ 套件,且其中的内容有助于当前任务,请先通过
kb-query 查阅,再从头作答——即使用户没有明确提出知识相关问题。
共享参考资料(唯一事实来源)
每个 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复制的种子内容。
评论
支持 Markdown