Codex跨时区协作实战：全球化团队场景教程

跨时区协作的关键不是追赶时间，而是让配置、知识和流程自动流转。北京团队下班前提交的 Codex 提示词，旧金山团队凌晨三点即可直接复用；柏林工程师修改的 .codex 配置，自动同步到班加罗尔的开发环境——这才是真正意义上的“异步协同”。简单来说，就是把开发者从等待中解放出来。

统一项目级配置：让所有人的Codex“说同一种语言”

第一步，在项目根目录创建 【.codex】 文件夹，里面必须包含两个文件：.codex/config.yaml 和 .codex/AGENTS.md。缺一不可，否则 Codex 启动时根本不会加载项目上下文。

第二步，在 config.yaml 中强制指定 mode: suggest，同时指定 style_guide: ./rules/eslint+prettier.json。注意，千万不要用 full-auto 模式——这个模式会在不同开发者的机器上生成风格迥异的代码，导致 Git 冲突率直接飙升 40% 以上，得不偿失。

第三步，把 AGENTS.md 当作团队的“宪法”来写。开头必须明确声明技术栈，比如“本项目仅使用 React 18 + TypeScript 5.3 + Vite 5”；末尾则要标注生效时间，例如“2026-05-28 起所有 PR 必须通过此 AGENTS.md 校验”。这样一来，无论谁在哪个时区，看到的规范都是统一的、不可动摇的。

建立异步提示词库：不用每次重写“请帮我写一个防抖函数”

方法一，在 .codex/prompts/ 目录下按功能分类建子目录，比如 ui/、api/、test/。每个文件建议用 zh-CN.md 和 en-US.md 双语命名，内容必须完全一致——这能有效防止因翻译偏差导致 AI 输出错乱，省去很多沟通成本。

方法二，给高频提示词加上版本号。比如 debounce-v2.1.md，末尾注明变更原因：“v2.1 → 增加对 AbortController 的兼容处理，适配 Safari 16.4+”。这样旧金山团队看到 v2.1，就知道不必再去翻原始 PR 记录，一目了然。

方法三，所有提示词文件顶部必须写明适用的 Codex 版本范围，格式为 。低于该版本的本地客户端会自动跳过加载，避免因语法报错中断工作流。

AI Code Review 的跨时区接力机制

将 Codex 审查嵌入 CI 流程，而不是依赖人工触发。在 GitHub Actions 中配置 codex-review@v1.9，关键参数设置为：review_mode: strict、timezone_handoff: "Asia/Shanghai→America/Los_Angeles"。

这一步操作起来虽然简单，直接把文件拖进去就行。但务必注意：【review_mode: strict 必须开启，否则 Codex 会跳过类型安全检查，旧金山团队第二天拉取代码时，很可能直接运行报错】。

举个例子，上海团队在 18:00 推送一个 PR，Codex 会自动完成首轮审查并标注出风险点；系统会在 02:00（洛杉矶时间）向旧金山成员推送 Slack 通知，附带审查摘要和可点击跳转的代码行链接；对方只需在评论区回复 /codex approve 或 /codex request-changes，连 IDE 都不需要打开。

交接文档自动化生成

在项目根目录添加 .codex/hooks/post-commit.hook，内容为调用 codex export --format=md --scope=last-commit，并将结果追加到 交接日志.md 底部。

每次 commit 后，这个脚本会自动生成三段式记录：① 修改了哪些文件；② Codex 建议的重构点是否被采纳；③ 是否触发了 .codex/rules/ 中定义的高危模式告警（比如硬编码密钥、未处理 Promise 拒绝等）。

班加罗尔团队每天晨会前，只需要扫一眼最新三条记录，就能判断是否需要介入——不需要等会议，也不需要看完整的 Git log。