# 这个知识库怎样组织

安装后生成的 `Knowledge` 对应日常知识库。解压目录中的安装器、测试和发行文档用于维护工作流，日常笔记写在 Knowledge 中。

## 三个知识区域

- `Projects`：具体项目的证据、判断、方法和当前状态。
- `Domains`：有来源的理论解释，或确有跨项目证据的共同经验。
- `Archive`：停止维护但仍有参考价值的项目。

## 项目按需要生长

第一次形成持久记录时，创建项目首页、Review 索引和记录。后续根据内容需要增加以下角色：

| 角色 | 帮读者回答什么 |
| --- | --- |
| 项目首页 | 这是什么项目，现在应该从哪里读 |
| STATUS | 当前源码、验证、交付和开放项怎样 |
| 故障模式 | 又出现类似现象时，先检查什么 |
| Guide | 怎样重新执行，并判断结果是否正确 |
| 机制笔记 | 为什么发生，哪些条件改变结果 |
| Review | 当时有哪些材料、怎样判断和验证 |

同一事实由一个文档负责，其他入口通过链接指向它。一次记录不必同时生成所有角色，也不以文件数量评判质量。

## 与 Note Base 的关系

核心文档职责与 Note Base 相同。提取版将完整规则和检查器集中到库内 `.agents/skills/knowledge-workflow`，通过根目录 `Check.ps1` 检查；本地 Note Base 使用的 Workflows、Skills、Tools 则是显式目录。

0.2.0 增加用户级调用入口和默认库位置记录。入口只负责找到目标知识库，再读取其中的完整规则；知识正文仍保存在 Knowledge，不会放进 Codex 用户配置。首次安装会记住位置，跨项目调用复用它；临时指定其他库不改变默认，更改长期默认需要明确请求。

详细职责规范随安装包保存在 `skills/knowledge-workflow/references/Debug_Review_Knowledge_Workflow.md` 的 2.2.1 节，工作流按需要读取。日常使用先从项目入口找到对应文档，不必先学习这些规则。

## 在其他源码项目中使用

默认安装已登记用户级入口，普通使用无需改每个项目的配置。下面的手工说明仅适用于选择 `-LocalOnly`、没有登记用户入口的方式；需要时合入原有 AGENTS.md，并替换为真实路径：

```text
本项目的知识库位于 D:\TeamKnowledge。
用户明确要求查询、记录、提炼或更正知识时，先读取
D:\TeamKnowledge\.agents\skills\knowledge-workflow\SKILL.md，按其中规则处理。
普通开发任务不自动写知识库；保留本项目原有规则和未提交内容。
```

这只是仅库内安装时的可选接入说明。默认安装只增加本包自己的用户入口与绑定，不重写其他项目、Codex config.toml 或全局 AGENTS.md；已有库的首页与 AGENTS.md 也不会在升级时被整份替换。
