知识库维护规则
本文件规定 Obsidian 知识母库怎么维护。目标是让知识库长期可读、可追溯、可被助手稳定调用。
三层职责
| 层 | 允许做什么 | 不允许做什么 |
|---|
| raw | 保存原始 DSL、文档、附件 | 不改写、不总结、不覆盖 |
| wiki | 把原文提炼成可执行说明 | 不放未经核对的硬规则 |
| rules | 保存必须执行的字段、验收、接入约束 | 不放背景介绍 |
新资料进入流程
DSL 案例卡规则
每个进入结构化知识层的 DSL，至少要有以下字段：
| 字段 | 说明 |
|---|
| 原始文件 | 指向 raw 里的 DSL |
| 适用场景 | 这个 DSL 解决什么生产问题 |
| 输入 | Start 节点变量 |
| 输出 | End 节点或最终交付物 |
| 核心节点 | 关键 LLM、Code、Tool、媒体生成节点 |
| 可复用点 | 新建或迭代 DSL 时可复用的设计 |
| 测试重点 | 应重点验证什么 |
| 待确认点 | 机器无法从 DSL 直接确认的内容 |
模板见 DSL案例卡模板。
规则抽取标准
以下内容必须进入 rules：
| 内容 | 示例 |
|---|
| 必填输入 | 输入缺失时不能启动能力 |
| 输出格式 | 必须返回后续环节可使用的成果 |
| 接入限制 | BOT 深度不能超过 5 层 |
| 验收门槛 | 至少跑通一次真实或准真实任务 |
| 状态流转 | 试点、上架、暂停、下架等状态 |
以下内容只放 wiki：
| 内容 | 示例 |
|---|
| 背景解释 | 为什么要建生产线 |
| 使用建议 | 某类场景适合哪个模板 |
| 案例说明 | 某个旧 DSL 的设计经验 |
修改规则
| 改动 | 要求 |
|---|
| 改目录 | 同步更新 index.md |
| 改案例卡 | 保留原始 DSL 链接 |
| 改硬规则 | 必须标明来源文档 |
| 改关系索引 | 不删除原始记录，先标记过期 |
命名规则
| 类型 | 命名 |
|---|
| wiki 页面 | 序号_中文说明.md |
| 案例卡 | 使用 DSL 应用名 |
| 规则文件 | 硬性规则清单.md |
| 关系文件 | xxx索引.md |