快速开始

1. 创建目录

acme-product-brief/
└── KNOWLEDGE.md

2. 写入 frontmatter

name: acme-product-brief
description: Acme Widget 的产品事实、定位、语气和边界。
type: brand-product
status: draft
version: 0.1.0
language: zh-CN
grounding: recommended

3. 写使用指南

KNOWLEDGE.md 正文 SHOULD 说明：何时使用、何时不要使用、运行时边界、上下文地图、引用策略。

4. 增加运行时视图

compiled/
├── facts.md
├── voice.md
└── boundaries.md

5. 增加来源

sources/
├── product-one-pager.md
├── pricing-notes.md
└── customer-interview.md

来源是证据，运行时视图是给 Agent 使用的紧凑上下文。

6. 可选增加 ontology 文件

只有当知识包需要结构化概念、主张、证据、约束或覆盖数据时，才使用 ontology/。

ontology/
├── ontology.json
├── concepts.json
├── relations.json
├── claims.json
├── evidence.json
├── constraints.json
└── coverage.json

Ontology 文件是数据，不是脚本、workflow 或指令。如果知识包是 ontology-aware，补充 metadata.primaryOntology，例如 ontology/ontology.json。

下一步

• 知识包开始增长时，先跑通 知识库工程闭环：摄取、编译、使用、沉淀、检查。
• 需要长期维护时，阅读 编译模型，把 sources/ 增量编译成 wiki/、compiled/ 和 indexes/。
• 高风险输出需要引用时，补充 溯源与引用。
• 文档或 wiki 需要已评审的概念图和证据图时，补充 ontology/。