保存能帮助下次判断的证据、解释和操作方法。使用标准 Markdown,可用 Obsidian 或编辑器阅读。
按目的查阅
| 现在要做什么 | 在项目中找什么 |
|---|---|
| 接着做当前任务,确认还有哪些开放项 | STATUS.md;只有确有需要时才建立 |
| 遇到相似现象,先决定查哪一步 | 故障模式与快速检查 |
| 按已验证的方法重新操作 | Guide |
| 理解原因、条件和设计边界 | 机制笔记,或 Domains 中的有来源解释 |
| 核对某次修改、失败、验证与交付 | Review 索引和对应记录 |
项目首页负责指路,正文各自保存依据。第一次记录只建必要文件;后续出现可复用方法或新的判断,再增加指南、故障模式等内容。
开始记录
在 Codex 中打开本目录,开启新会话,然后试着说:
把下面这次任务的结论保存到知识库。项目是 DEMO-Queue。……
也可以显式调用 $knowledge-workflow。先给出真实材料、来源和已完成的验证;没有实施或测试的方案应如实保留状态。
只查询或解释时直接提问,默认不写入。第一次记录时再创建项目,不用先填满目录。
保存后让 Codex 运行检查,也可在本目录执行 pwsh -NoProfile -File ./Check.ps1。
规则入口位于 .agents/skills/knowledge-workflow/SKILL.md,规范位于它的 references 目录,只有一份权威内容。在其他源码项目中使用时,需要明确知识库位置和这个入口;安装不会修改全局设置。