跨时区协作的核心并非被动追赶时间，而是让配置、知识与流程实现自动流转。当北京团队下班前提交的 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。