结论先说
- 团队落地切忌把所有规则都塞进一份巨型文档。Codex 生态已经把规范清晰拆成了四层:
AGENTS.md管项目背景与开发习惯,.rules管命令审批边界,Skills管高频流程复用,requirements.toml管管理员不可逾越的安全底线。 - 明确区分「进 Git 仓库共享」和「不进仓库的本地/系统层」。
AGENTS.md、团队级.rules与.agents/skills/应像业务源码一样纳入 Git 仓库走 PR 评审;管理员级requirements.toml应通过 IT/设备管理下发到系统受管目录,个人~/.codex/config.toml与凭据则严禁提交。 - 软指令绝不能替代硬沙箱与审批策略(本站建议)。在
AGENTS.md里写「请勿删除数据库或读取.env」只是软提醒,真正要防止误执行高危命令,必须叠加.rules审批限制与requirements.toml沙箱策略锁死下限。 - 先单仓试点,再按需抽象 Skills,严防规则膨胀。根
AGENTS.md建议控制在精炼可读的 100 至 200 行以内,把细分模块的规矩放到子目录AGENTS.md,把超长步骤流程封装到按需触发的SKILL.md里,既省上下文额度又减少指令打架。 - 团队规模化推行 Codex,除了仓库规范,还需要稳定合规的账号与配额支撑。多人研发团队可在本站直接了解 ChatGPT Business 团队定制,个人骨干与重度开发者也可按需配置 ChatGPT Plus 或高配额 ChatGPT Pro。

图:本站根据 OpenAI Codex 官方文档 与 AGENTS.md 规范 整理的示意图
本文根据 OpenAI Codex 官方开发者文档、AGENTS.md 开放规范及团队工程治理实践整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 已经有 3 人以上研发团队在日常使用 Codex CLI、IDE 扩展或桌面端,但每个人的提示词、代码风格与命令权限各玩各的技术负责人;
- 希望把团队测试规程、发布检查单和安全护栏版本化,让新同事克隆仓库就能开箱继承一致 Codex 行为的工程团队;
- 需要向安全合规部门讲清「哪些约束靠提示词、哪些边界靠规则与系统策略强控」的架构师。
一、推荐的团队仓库目录结构模板
先用一张标准目录树把「该进 Git 的」与「该留本地的」彻底划清:
text
my-team-repo/
├── AGENTS.md # 仓库级总指南(架构、命令、Git 与审查规范)
├── services/
│ └── billing/
│ └── AGENTS.md # 子模块专属规范(仅改该目录时叠加生效)
├── .codex/
│ ├── rules/
│ │ └── team-default.rules # 团队共享命令审批守则(按前缀细化放行/拒绝)
│ └── config.toml # 可选:极简项目级非敏感默认项(不含密钥)
├── .agents/
│ └── skills/
│ ├── db-migration-check/
│ │ ├── SKILL.md # 技能说明与触发条件
│ │ └── scripts/check.sh # 确定性校验脚本
│ └── release-checklist/
│ └── SKILL.md
└── .gitignore # 务必忽略 .codex/*.log、本地覆盖与临时密钥
与此同时,在研发终端的系统受管路径由运维或 IT 统一下发 requirements.toml,确保全员设备遵守一致的沙箱隔离级别与禁用名单。注意,个人本地的 ~/.codex/config.toml、登录缓存以及任何 .env、API Key 都不应被纳入仓库。
二、5 步在团队仓库中渐进落地

图:本站根据多人团队推广经验整理的落地步骤示意图
第 1 步:写出短而准的 AGENTS.md(配合子目录分层)
不要把公司百科全书贴进 AGENTS.md,重点只写「如果一个新同事第一天入职,最怕踩坑的 5 件事」。可以按下面这份精简模板起步:
markdown
# 项目开发与协作规范
## 常用验证命令
- 安装依赖:`pnpm install --frozen-lockfile`
- 单元与类型检查:`pnpm typecheck && pnpm test -- --run`
- 代码格式化:`pnpm lint`
## 目录与边界
- `apps/web` 为前端应用,`packages/shared` 为公共类型,禁止在前端直接引用 `services/` 内部实现。
- 涉及数据库表结构改动时,必须同步生成迁移脚本并更新回滚说明。
## Code Review Rules
- 重点核查权限校验缺失、SQL 参数拼接、未处理的空值与并发竞态。
- 禁止把无关文件的整页格式化变更混入业务提交。
如果是大型 Monorepo,前端、后端和移动端各自把专有规矩放进子目录的 AGENTS.md,避免互相污染上下文。详细的读取顺序与覆盖优先级可对照 /guides/codex-agents-md-how-it-reads 与 /guides/codex-agents-override-md-hierarchy-priority。
第 2 步:用 .rules 划清命令执行红绿灯
光靠提示词提醒不够稳妥,团队应在 .codex/rules/ 下把日常高频命令分三档管理:
- 绿灯(可低摩擦执行):只读信息查询、单测执行、类型检查与静态 Lint;
- 黄灯(必须人工确认):安装新依赖、修改锁文件、执行本地数据库迁移脚本;
- 红灯(明确拦截):向远端强推
git push --force、直接访问生产环境凭据或批量删除受保护目录。
关于保护 .env 等敏感文件读取与权限预设组合,可进一步查阅 /guides/codex-permission-profiles-block-env-config。
第 3 步:把跨人重复的高频流程沉淀为仓库级 Skills
一旦团队里超过两个人反复写同一段几百字提示词(例如「按公司 OpenAPI 规范生成接口与错误码」「做数据库迁移安全核查」),就不要继续往 AGENTS.md 里硬塞,而是抽成 .agents/skills/<name>/SKILL.md 并附带确定性校验脚本。因为 Skills 采用按需加载机制,平时不占基础上下文,需要时再触发,既省配额又一致。完整编排写法与模板可看 /guides/codex-custom-skill-md-scripts-templates-team-guide。
协作与订阅提示:多人团队统一落地 Codex 后,核心骨干在架构重构与 PR 审查上的配额需求往往远高于轻度对话用户。高强度主力研发可单独配齐 ChatGPT Pro 充值 或 ChatGPT Pro 5x 档位;若新同事注册账号遇到手机验证环节,可参考 Codex 注册手机验证服务。
第 4 步:由管理员统一维护 requirements.toml 锁死安全底线
需要特别强调一个认知误区:requirements.toml 的设计初衷是管理员强制策略,如果仅仅把它丢在普通研发人员随时能改的业务 Git 仓库里,它就起不到强制隔离作用。正确做法是将企业的策略标准文档化进运维配置仓库(如 MDM / Ansible / Intune 模板),统一下发到研发机系统受管路径,锁定不允许关闭沙箱、不允许越权网络访问或限制特定外部工具。详细字段与部署层级请阅读 /guides/codex-requirements-toml-enterprise-policy-guide,配合 /guides/codex-config-toml-complete-guide 厘清上下级覆盖关系。
第 5 步:把规范纳入 PR 评审与月度瘦身(本站建议)
团队规范一旦「只增不减」,半年后就会充满过期的旧命令,反而误导 Codex。建议指定一名仓库 Owner,在每次框架升级或测试命令调整时同步更新 AGENTS.md 与 SKILL.md,并且把所有规范改动都走普通 Pull Request 评审合入。
常见问题
问:项目仓库里要不要顺手提交一份 .codex/config.toml 把所有成员的模型型号焊死?
答:建议克制(本站建议)。团队项目级配置里只适合放与业务强相关的非敏感参数;像个人习惯使用的终端主题、快捷键、本地推理档位或私有认证,最好留给成员在 ~/.codex/config.toml 自由调整,避免频繁引发本地 git status 脏改动。
问:团队同时有人用 Codex CLI、有人用 VS Code 扩展,也有人用其他 AI 编程工具,规范要写两份吗?
答:不需要重复造轮子。AGENTS.md 与 Agent Skills(SKILL.md)都遵循跨工具开放标准,放在仓库标准路径下即可被主流工具共同识别复用;仅在权限审批与企业受管策略层按对应工具规范补充即可。
问:国内没有外币企业信用卡,研发团队怎么统一采购 ChatGPT 团队版或高配额 Pro 订阅并开具发票?
答:可前往本站 AI 会员充值总览 按需选购 ChatGPT Business 团队定制、ChatGPT Plus 充值(含 Plus iOS 可覆盖版)或高配额 ChatGPT Pro 20x 档位。平台支持支付宝、微信支付与 AlipayHK,提供自助卡密兑换与增值税发票服务,具体以商品页实时展示为准;售后遵循掉订阅按剩余天数折退、封号不在质保范围内的规则。
相关教程
- Codex 如何读取与合并 AGENTS.md 指令文件
- Codex AGENTS.md 与覆盖层级优先级详解
- Codex 自定义 SKILL.md、脚本与团队模板实战指南
- Codex requirements.toml 企业级策略配置指南
- Codex 权限预设与禁止读取 .env 敏感配置指南
参考资料
- OpenAI Codex 官方开发者文档 — https://developers.openai.com/codex
- AGENTS.md 开放规范官网 — https://agents.md/
- OpenAI Codex 官方 GitHub 仓库 — https://github.com/openai/codex
- OpenAI Codex 官方文档:Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting
0 条评论
还没有评论,来抢沙发~