跨时区协作靠配置、知识和流程自动流动：统一项目级配置（.codex/config.yaml与AGENTS.md）、建立双语版本化提示词库、AI Code Review跨时区接力、提交后自动生成结构化交接日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当北京团队下班前提交的 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 版本范围，格式为 <!-- codex>=1.8.0 < 2.0.0 -->。低于该版本的本地客户端会跳过加载，防止语法报错中断工作流。
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。
