---
description: "Codex 团队实践指南，整理 AGENTS.md、PR、排障、知识库、任务模板和团队推广的协作方法。"
---

# 团队实践

团队使用 Codex 的关键是把规则写清楚、把验证跑起来、把案例沉淀下来。

![Codex 安全边界分层](/images/codex-safety-layers.svg)

## 团队接入清单

| 项目 | 建议 |
| --- | --- |
| `AGENTS.md` | 写清项目结构、命令、风格、安全边界 |
| 测试命令 | 提供最小相关测试和全量测试命令 |
| PR 模板 | 要求说明 Codex 参与范围、验证结果和风险 |
| 安全规则 | 明确生产数据、密钥、发布、迁移的审批要求 |
| 案例库 | 把成功任务和失败复盘都沉淀下来 |

## 团队版 AGENTS.md 提纲

```markdown
# AGENTS.md

## 项目概览

## 常用命令

## 目录边界

## 代码规范

## 测试要求

## 安全边界

## PR 交付要求
```

## PR 描述模板

```markdown
## 背景

## 改动

## Codex 参与范围

## 验证

## 风险

## 截图或日志
```

## 例会复盘问题

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

::: info 截图占位
请补充团队 PR 中 Codex 参与说明的截图。建议文件：`docs/.vuepress/public/screenshots/cloud/03-pr-codex-summary.png`。
:::