安装后生成的 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,并替换为真实路径:
本项目的知识库位于 D:\TeamKnowledge。
用户明确要求查询、记录、提炼或更正知识时,先读取
D:\TeamKnowledge\.agents\skills\knowledge-workflow\SKILL.md,按其中规则处理。
普通开发任务不自动写知识库;保留本项目原有规则和未提交内容。
这只是仅库内安装时的可选接入说明。默认安装只增加本包自己的用户入口与绑定,不重写其他项目、Codex config.toml 或全局 AGENTS.md;已有库的首页与 AGENTS.md 也不会在升级时被整份替换。