团队实践

一个人用 Codex，重点是跑通自己的工作流。团队用 Codex，重点是把规则写清楚、把验证跑起来、把成功和失败都沉淀下来。

团队最容易出问题的地方不是“AI 不够聪明”，而是：每个人给 Codex 的边界不同、验收标准不同、风险意识不同。最后结果看起来热闹，但没人敢放心复用。

这节课解决什么问题

团队落地要解决 4 件事：

1. 让 Codex 知道项目规则。
2. 让每次任务都有验证证据。
3. 让高风险动作有人确认。
4. 让成功经验沉淀成模板，而不是停留在某个人的聊天记录里。

团队接入清单

项目	建议	验收标准
AGENTS.md	写清项目结构、命令、风格、安全边界	新对话能读到项目规则
测试命令	提供最小相关测试和全量测试命令	PR 里能看到验证结果
任务模板	统一目标、材料、范围、验证、交付	新人也能照着发任务
PR 模板	要求说明 Codex 参与范围、风险和截图	审查者知道 AI 改了哪里
案例库	保存成功任务和失败复盘	下次同类任务不从零开始

AGENTS.md 提纲

# AGENTS.md

## 项目概览

## 常用命令

## 目录边界

## 代码规范

## 测试要求

## 安全边界

## PR 交付要求

推荐继续读：AGENTS.md 项目规则。

团队任务模板

把这段放进团队文档里，新人也能照着用：

目标：

背景和材料：

范围：

禁止事项：

验证方式：

交付格式：

如果你发现信息不足，请先列出缺口，不要直接猜。

共享规则与个人偏好

团队共同规则放进 AGENTS.md，例如项目结构、命令、测试要求、目录边界和安全红线。

个人本机路径、私有工具习惯、临时限制和回复偏好，可以参考 团队共享规则和本地私有规则 拆到 AGENTS.local.md。私有规则不要提交到仓库。

PR 描述模板

## 背景

## 改动

## Codex 参与范围

## 验证

## 风险

## 截图或日志

例会复盘问题

每周用 15 分钟复盘，不需要复杂仪式：

• 哪类任务 Codex 表现稳定？
• 哪类任务容易失控或需要更强约束？
• 哪些命令、规则、截图说明应该写入 AGENTS.md？
• 哪些成功案例可以沉淀成模板？
• 哪些失败案例应该写入排障手册？

团队成熟度

阶段	状态	下一步
试用	个别人偶尔使用 Codex	收集 3 个低风险成功案例
扩散	团队开始共享 prompt 和截图	建立任务模板和 PR 模板
规范	项目有 AGENTS.md 和验证要求	建立案例库与排障手册
稳定	Codex 进入日常交付流程	把重复流程沉淀成 Skill 或自动化

验收标准

学完这一页后，团队应该能做到：

• 有一份最小可用 AGENTS.md。
• 有统一任务模板和 PR 描述模板。
• 每次 Codex 参与的交付都能说明验证证据。
• 至少沉淀 3 个成功案例和 1 个失败复盘。