0.2.0 试用版 · Windows + Codex

知识库怎样组织

知识正文、默认位置与工作流规则各自放在哪里。

安装后生成的 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 也不会在升级时被整份替换。

下载附件