10 · 团队协作和生产环境怎么落地

⏱️ 预计阅读 12 分钟 ｜ 🎯 目标：把"我自己用 Codex"升级到"团队 / 生产环境用 Codex"

个人用 Codex 关心"我能不能更快完成任务"；团队用 Codex 关心"流程是否可控、结果是否可审查、权限是否安全"。这是一道质变的门。

🎬 个人 vs 团队：关心的事完全不同

flowchart LR
    subgraph Solo["👤 个人用 Codex"]
        S1[更快完成任务]
        S2[少敲键盘]
        S3[自己审 diff 自己合]
    end

    subgraph Team["👥 团队 / 生产用 Codex"]
        T1[流程可审查]
        T2[变更有记录]
        T3[权限有边界]
        T4[多人不踩脚]
        T5[出事能追溯]
    end

    Solo --> Team

    style Solo fill:#dbeafe,stroke:#3b82f6
    style Team fill:#dcfce7,stroke:#22c55e

💡 质变点：个人模式下 Codex 是"加速器"，团队模式下 Codex 是"协作成员"。 协作成员要满足组织的可控性、可审查性、可追溯性。

🧱 团队落地 5 大支柱

flowchart TB
    Team[👥 团队用 Codex]

    P1[📜 共识层<br/>AGENTS.md 上 git]
    P2[🛡️ 边界层<br/>requirements.toml 强制管控]
    P3[🐙 集成层<br/>GitHub / Slack / Linear]
    P4[🤖 自动化层<br/>CI 跑 Codex / PR 自动 review]
    P5[📊 治理层<br/>用量监控 / 审计日志]

    Team --> P1 & P2 & P3 & P4 & P5

    style P1 fill:#dcfce7,stroke:#22c55e
    style P2 fill:#fee2e2,stroke:#ef4444
    style P3 fill:#dbeafe,stroke:#3b82f6
    style P4 fill:#fef3c7,stroke:#f59e0b
    style P5 fill:#f3e8ff,stroke:#a855f7

1️⃣ 共识层：AGENTS.md 提交进 git

回顾第 4 篇：AGENTS.md 是项目和 Agent 的接口。团队场景下它必须 commit 进仓库：

仓库根/
├── AGENTS.md                ← 全仓共识规则
├── packages/
│   ├── api/AGENTS.md        ← 后端独有规则（数据库迁移禁止事项）
│   └── web/AGENTS.md        ← 前端独有规则
└── .agents/
    └── skills/              ← 团队共享 Skills
        └── pr-review/

关键约定：

✅ AGENTS.md 是法律级文档，PR 必须经过 review 才能改 ✅ 嵌套加载（参考第 3 篇）让子团队有自治空间 ✅ 跨团队规则（如「不准 push --force」）写根目录，不可被子目录覆盖

2️⃣ 边界层：requirements.toml 是企业的安全底线

OpenAI 给企业的强力武器：requirements.toml，员工无权覆盖。

# IT 下发的 requirements.toml
[disallow]
approval_policy = ["never"]              # 禁止"从不询问"
sandbox_mode = ["danger-full-access"]    # 禁止全权限模式

[required_hooks]
before_apply_patch = "/opt/sec/scan-diff.sh"   # 强制 diff 安全扫描
after_mcp_call = "/opt/audit/log.sh"            # 强制审计日志

典型场景：

📖 来源：Configuration Reference

3️⃣ 集成层：Codex 进 GitHub / Slack / Linear

Codex 不是孤岛。进入团队工具流是放大杠杆的关键：

4️⃣ 自动化层：Codex 进 CI

CLI 的杀手级用法：用 codex exec 进任何 CI 流水线。

# .github/workflows/codex-pr-review.yml
name: Codex PR Review
on: pull_request

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Codex Review
        run: |
          codex exec "评审本 PR 的 diff，按 AGENTS.md 规则
          列出风险、建议、必改项"
        env:
          CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}

典型 CI 用法：

5️⃣ 治理层：用量、审计、合规

flowchart LR
    subgraph Vis["📊 可见性"]
        U[用量看板<br/>谁烧多少 token]
        L[审计日志<br/>谁做了什么]
        R[风险报告<br/>哪些 PR 高风险]
    end

    subgraph Act["⚙️ 干预手段"]
        Cap[配额封顶]
        Block[黑名单 MCP]
        Force[强制 hooks]
    end

    Vis --> Act

    style Vis fill:#dbeafe,stroke:#3b82f6
    style Act fill:#fef3c7,stroke:#f59e0b

ChatGPT Business / Enterprise 提供：

• 📊 用量看板：按用户 / 项目 / 模型聚合
• 🔍 审计日志：所有 Agent 行动可追溯
• 🛡️ 配额管理：防个别员工烧爆预算
• 🔐 数据保留策略：合规要求的数据保留期

🚀 团队上手 4 步路线图

flowchart LR
    W1["第 1 周<br/>📜 写 AGENTS.md<br/>团队最小规则集"]
    W2["第 2 周<br/>🛡️ 设 requirements.toml<br/>安全底线"]
    W3["第 3-4 周<br/>🤖 接 GitHub PR 自动 review"]
    M2["第 2 个月<br/>📊 治理 + 用量监控"]

    W1 --> W2 --> W3 --> M2

    style W1 fill:#dcfce7,stroke:#22c55e
    style W2 fill:#fee2e2,stroke:#ef4444
    style W3 fill:#dbeafe,stroke:#3b82f6
    style M2 fill:#f3e8ff,stroke:#a855f7

💡 不要一次性铺所有支柱。从 AGENTS.md 开始，让团队习惯 → 加边界 → 加集成 → 加治理。

🚫 常见误解 → ✅ 正确理解

🔍 想再深一层（点击展开）

# 团队工作规则

## 项目概况
{项目用途 + 技术栈}

## 协作流程
- 所有改动走 PR，禁止直推 main
- PR 必须经至少 1 人 review + CI 全绿
- 跨模块改动需要相关 owner 批准

## 命令约定
- 包管理器：pnpm（不要用 npm/yarn）
- 测试：`pnpm test`
- 构建：`pnpm build`
- 类型检查：`pnpm typecheck`

## 禁止事项（所有 Agent 必须遵守）
- ❌ 不改 .env / secrets/
- ❌ 不动 db migration（需 DBA review）
- ❌ 不改 .github/workflows/（需 platform team review）
- ❌ 不 push --force
- ❌ 不直接改 main / master 分支

## 验收要求
- 改 UI：截图 + 桌面端 + 移动端
- 改 API：补集成测试
- 改数据库：迁移脚本 + 回滚脚本
- 改安全 / 权限：必须人工 review，禁止 Codex 直接 merge

# .github/workflows/codex-suite.yml
name: Codex Suite

on:
  pull_request:
  schedule:
    - cron: '0 9 * * 1'   # 每周一 9 点跑文档扫描

jobs:
  pr-review:
    if: github.event_name == 'pull_request'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: codex exec "review the diff per AGENTS.md"
        env:
          CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}

  weekly-doc-scan:
    if: github.event_name == 'schedule'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: codex exec "scan README + docs for outdated info"

📝 本章自检

✅ 过关标准： "个人模式 Codex 是加速器；团队模式 Codex 是协作成员，需要满足可审查、可追溯、可控制。"

📚 下一篇

• ➡️ 11 · 从理解到实战场景 —— 模糊需求如何变成可执行任务
• 📖 用 Codex 做 GitHub 代码审查
• 🤖 用 GitHub Action 跑 Codex
• 💬 从 Slack 使用 Codex
• 📋 从 Linear 使用 Codex
• 📊 做治理和可观测