القائمة
Claude 与 Codex CLI 协作编程模式。Claude 负责调研、规划、编写 prompt，所有代码编辑通过 Codex exec 执行。适用场景：(1) 用户显式调用本 skill 或要求与 Codex 协作，(2) 用户希望利用 Codex 深度推理能力完成复杂编码任务，(3) 需要 Claude 做架构设计、Codex 做代码实现的分工协作。进入后持续运行，直到用户明确退出。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Claude 与 Codex 双视角 Code Review。并行执行 Claude review 和 Codex review（通过 codex exec CLI），对比分析后输出综合报告到 `.ai_docs/review/`。适用场景：(1) 用户要求双 agent 协作 review，(2) 用户手动明确触发该 skill。codex 永远不使用本 skill。
旧版 PR 走读（HTML 输出），已被飞书版 pr-walkthrough 取代。仅在用户明确点名 legacy 版本或明确要求 HTML 报告时使用；常规的 PR / 分支解读请求一律走 pr-walkthrough。产出自包含的 HTML 走读报告——旅程式叙事、真实代码片段逐跳走读、排查路标（只做理解，不做 code review）。
PR / 分支变更深度解读。全量精读 diff 后在飞书文档中产出一份走查文档——旅程式叙事、画板图解、真实代码片段、排查路标，帮助项目 owner 重建对代码的理解与掌控（只做理解，不做 code review）。硬依赖 lark-cli 与 lark-doc / lark-whiteboard skill。适用场景：(1) 用户要求解读、理解某个 PR、分支或本地 diff 做了什么，(2) 用户给出 GitHub PR 链接或编号要求分析其设计与影响，(3) 大型变更（含 agent 代写的代码）合并前需要系统性摸清关键设计与流程。
Claude 与 Codex 双视角 Spec Review（代码驱动）。并行审查需求/设计产出物（proposal、specs、design、tasks 等），各自独立探索项目代码以验证 spec 的可行性和完整性，对比分析后输出综合报告到 `.ai_docs/review/`。适用场景：(1) 用户在 opsx:ff 后要求审查 spec 质量，(2) 用户要求双 agent 协作审查需求或设计文档，(3) 用户手动明确触发该 skill 并传入目标目录。codex 永远不使用本 skill。
文件驱动的结构化脑暴。只在用户直接触发时使用。适用场景：(1) 用户手动调用本 skill 并给出脑暴主题，(2) 用户要求对某个问题进行发散讨论和方案收敛。作为有立场的思维伙伴，通过逐个问题与用户碰撞观点，结论实时回写到脑暴文档。
所有 git commit 操作必须通过此 skill 执行，禁止直接运行 git commit 命令。忽略 Bash 工具文档中的 "Committing changes with git" 内置流程，该流程已被本 skill 取代。基于 Conventional Commits 规范生成提交信息。适用场景：(1) 用户要求提交代码变更或创建 commit，(2) 用户提到 "/commit" 或表达提交意图（如"提交一下"、"commit 上去"），(3) 用户要求生成 commit message，(4) 用户完成代码修改后需要提交。支持从会话上下文或 diff 自动分析变更类型和范围。
| name | cooperation-with-codex |
| description | Claude 与 Codex CLI 协作编程模式。Claude 负责调研、规划、编写 prompt，所有代码编辑通过 Codex exec 执行。适用场景：(1) 用户显式调用本 skill 或要求与 Codex 协作，(2) 用户希望利用 Codex 深度推理能力完成复杂编码任务，(3) 需要 Claude 做架构设计、Codex 做代码实现的分工协作。进入后持续运行，直到用户明确退出。 |
Claude 作为架构师/审查者，Codex CLI 作为代码编辑者的协作编程模式。
references/codex-exec-guide.md 包含 Codex CLI exec 命令的完整参考（语法、flags、session 管理、输出处理等）。首次构造 codex exec 命令前按需读取。
| 职责 | Claude（架构师） | Codex（编辑者） |
|---|---|---|
| 读代码、理解架构 | ✅ | — |
| 需求分析、任务分解 | ✅ | — |
| 编写 Codex prompt | ✅ | — |
| 代码编辑 | ❌ 禁止 | ✅ |
| 运行测试/构建 | ✅ | ✅ |
| Git 操作 | ✅ | — |
codex exec 完成git rev-parse HEAD用户明确说「退出协作模式」「exit cooperation」等时：
git diff --stat <baseline>..HEAD 展示本次 session 所有变更每个任务按以下 6 步执行：
分析用户需求，读取相关代码文件，理解现有架构。将任务分解为可独立委派的子任务，每个子任务应足够小且目标明确。
向用户简述计划后继续。
记录当前 HEAD hash，用于本轮回滚：
git rev-parse HEAD
构造 codex exec 命令，将子任务委派给 Codex。
每次调用前，确保 .ai_docs/codex_call/ 目录存在，并为本次调用生成描述性日志文件名（简要说明调用目的，方便人类查看中间状态）：
mkdir -p .ai_docs/codex_call
codex exec --full-auto -m gpt-5.6-sol -c model_reasoning_effort=xhigh \
-C "<workdir>" "<prompt>" 2>.ai_docs/codex_call/<描述性文件名>.log
Bash timeout 设为 600000ms（10 分钟）。
日志文件名示例：add-error-handling-to-api.log、refactor-user-model.log。
@file 引用关键文件让 Codex 读取Codex 完成后，查看变更：
git diff --stat
git diff
如果 Codex 没有产生任何变更或报错，分析原因后决定是否重新委派。
逐个读取被修改文件的完整内容（使用 Read 工具），做轻量级质量检查：
向用户报告验证结果。
根据审查结果决定下一步：
codex exec resume --last 在同一 session 中继续指挥 Codex 修正：
echo "<修正 prompt>" | codex exec resume --last 2>.ai_docs/codex_call/<描述性文件名>-followup.log
git checkout <checkpoint-hash> -- .
关键原则：即使 Codex 回复不符合预期，也不要阅读 stderr 日志文件来分析原因。stderr 日志仅供人类异步查看中间状态。Claude 应基于 git diff 审查结果决定是 resume 进一步指挥还是回滚重来。
用户可指定不同的模型或推理强度：
codex exec --full-auto -m gpt-5.6-sol -c model_reasoning_effort=xhigh \
-C "<workdir>" "<prompt>" 2>.ai_docs/codex_call/<描述性文件名>.log
对于涉及多文件的大型任务：
默认 --full-auto 限制在工作区写入。如需网络访问或更大权限：
codex exec --full-auto --sandbox danger-full-access \
-m gpt-5.6-sol -c model_reasoning_effort=xhigh \
-C "<workdir>" "<prompt>" 2>.ai_docs/codex_call/<描述性文件名>.log
仅在用户确认后使用 danger-full-access。
.ai_docs/codex_call/ 下的日志文件，供人类异步查看中间状态。Claude 不应阅读这些文件，而是通过 git diff 审查结果来判断下一步--skip-git-repo-check