知识库调用规则
本文件规定项目经理 Agent 和各个 skill 在自动化搭建流程中如何读取知识库。
它只管“怎么调用知识”，不管“怎么维护知识”。维护规则仍以 schema.md 和 知识库维护指南 为准。
1. 一句话原则
每次任务先读入口和硬规则，再按当前节点读取对应 wiki、relations 或 raw。资料不足时停止并说明缺什么，不猜、不补、不伪造。
2. 全局读取顺序
| 顺序 | 必读内容 | 读取者 | 作用 |
|---|
| 1 | index.md | 项目经理 Agent | 找到知识库入口和目录 |
| 2 | 知识库调用规则.md | 项目经理 Agent | 确认本次任务允许读取什么 |
| 3 | 硬性规则清单 | 项目经理 Agent、所有 skill | 获取必须执行的输入、执行、输出、验收规则 |
| 4 | 对应 wiki 页面 | 对应 skill | 获取结构化知识 |
| 5 | 对应 relations 页面 | 方案确认、方案执行、方案测试 | 查找 DSL 摘要、案例关系、原始资料位置 |
| 6 | 对应 raw 原文 | 方案执行、方案测试 | 核对旧 DSL 或原始规范 |
schema.md 是知识库维护规则，不是每次任务的默认必读文件。只有新增、废弃、调整知识库内容时才需要读取。
3. 分节点读取范围
4. 按 pipeline 读取范围
5. raw 原文读取规则
| 规则 | 说明 |
|---|
| raw 默认不读 | 日常判断和方案确认先读 wiki 和 relations |
| 需要核对时才读 raw | 例如迭代旧 DSL、核对原始规范、确认案例卡是否准确 |
| raw 只读 | 不允许修改、覆盖、删除、移动 raw 原文 |
| 读取 raw 要说明原因 | 输出中必须写清楚为什么读了哪个 raw 文件 |
| raw 不直接覆盖硬规则 | 如果 raw 和 rules 冲突，先暴露冲突，不能自行选择 |
6. 优先级规则
| 优先级 | 内容 | 说明 |
|---|
| 1 | 事务单据 | 本次任务的直接要求最高 |
| 2 | 硬性规则清单 | 输入、执行、输出、验收的强约束 |
| 3 | 执行方案 | 方案执行和方案测试必须按执行方案走 |
| 4 | wiki 结构化知识 | 用于理解场景、模板、测试和接入 |
| 5 | relations 索引 | 用于找案例、旧 DSL 摘要和关系 |
| 6 | raw 原文 | 用于核对来源，不直接作为默认执行规则 |
如果出现冲突，不能自行忽略低优先级资料，必须在输出中写入 conflict_fields（冲突字段）或 plan_risks（方案风险）。
7. 资料不足处理
| 情况 | 处理 |
|---|
| 缺事务单据关键字段 | 停止，返回 missing_fields（缺失字段） |
| 缺旧 DSL 但明确要基于旧 DSL 迭代 | 停止，要求补充旧 DSL 地址 |
| 写的是优化/调整但没有旧 DSL | 按新建 DSL 流程处理，并在方案确认中说明这是新建版本 |
| 找不到相似案例 | 可以继续，但必须说明没有相似案例，不得编造案例 |
| 缺测试输入、权限或环境 | 测试失败，不得标记成功 |
| wiki 和 raw 内容冲突 | 停止或标记风险，等待人工确认 |
8. 每个节点必须输出的知识字段
| 字段（英文） | 中文名称 | 说明 |
|---|
knowledge_scope | 知识库范围 | 本节点允许读取的知识范围 |
knowledge_used | 已使用知识 | 本次实际读取过的文件列表 |
knowledge_gaps | 知识缺口 | 本次缺少的资料、字段或案例 |
knowledge_conflicts | 知识冲突 | 本次发现的规则、案例或原文冲突 |
项目经理 Agent 检查各 skill 输出时，必须检查这些字段是否存在。没有使用知识库的节点，也要输出空数组。
9. 与现有文件的关系
10. 标准提示词
请使用知识库：
/Users/ljn/Desktop/自动化搭建/AI生产线知识库
先读取 index.md、知识库调用规则.md、rules/硬性规则清单.md。
然后根据当前节点和 pipeline，只读取知识库调用规则允许的文件。
不要直接翻 raw 猜答案；只有核对原文、迭代旧 DSL 或验证来源时才读取 raw。
资料不足时直接返回缺失字段、知识缺口或冲突，不要补字段、不要编造案例、不要把失败标记为成功。