团队知识工作流：把 Agent 经验留在仓库里
采集日期：2026-06-17。复测日期：2026-06-17。
团队使用 Codex 时，最大浪费不是一次任务失败，而是每个人都在重复解释项目规则、重复踩坑、重复修同类问题。知识沉淀的目标是：让下一个人和下一个 Agent 都能少走弯路。
- 项目规则进 AGENTS.md。
- 当前任务进 spec / plan。
- 可公开解释进 Wiki。
- 验证证据进复测记录。
- 交付过程进 PR。
- 跨项目偏好才进 Memory。
这些边界和 Context / Memory / AGENTS.md 是同一套逻辑。
团队知识资产表
Section titled “团队知识资产表”| 资产 | 写什么 | 谁会用 |
|---|---|---|
| AGENTS.md | 项目根目录、验证命令、禁改范围 | Agent 和开发者 |
| docs / Wiki | 概念、FAQ、实战方法 | 新手和搜索用户 |
| spec / plan | 本次改造目标和验收 | 当前任务执行者 |
| verification log | 构建、部署、截图、复测日期 | 维护者和审核者 |
| PR 描述 | 改了什么、怎么测、风险 | Reviewer 和未来维护者 |
| Memory | 长期协作偏好和机器坑 | 跨项目 Agent |
什么必须沉淀
Section titled “什么必须沉淀”- 反复出现的报错。
- 反复使用的 prompt 或审核清单。
- 新手容易误解的概念。
- 和成本、安全、部署、账号有关的边界。
- 线上页面、构建、部署的复测结果。
什么不该沉淀进团队仓库
Section titled “什么不该沉淀进团队仓库”- 私人 token、cookie、账号信息。
- 只对某个开发者机器有效的绝对路径。
- 没来源的社区判断。
- 已归档工具的旧命令。
- 没有日期的技巧合集。
团队工作流建议
Section titled “团队工作流建议”- 开工前：确认 AGENTS.md 和当前 spec。
- 执行中：让 Codex 输出将改文件、风险和验证方式。
- 完成后：更新复测记录和相关 Wiki。
- PR 前：跑构建、跑审查、附上结果。
- 复盘时：只把可复用经验沉淀成 Skill 或 Memory。
- 看三件套：读 Spec / Skill / Memory 三件套。
- 看 PR 流程：读 Worktree / GitHub / PR。
- 看复测记录：读 内容复测记录。
- 看项目规则边界：读 Context / Memory / AGENTS.md。
- 来源：本站 Codex 项目协作实践、OpenAI AGENTS.md。
- 站内关联：Spec / Skill / Memory、内容复测记录。
- 分享日期：2026-06-17。
- 复测日期：2026-06-17。