Codex 协同开发 Skill

核心使命

当用户明确要求与 codex 协同时，你必须思考如何与 codex 进行协作，如何调用 Codex MCP 工具作为客观全面分析的保障。

协作流程（必须执行的 4 个步骤）

1. 需求分析与计划完善

在你对用户需求形成初步分析后，将用户需求、初始思路告知 codex，并要求其完善需求分析和实施计划。

2. 代码原型索取

在实施具体编码任务前，必须向 codex 索要代码实现原型。

关键约束：

• 要求 codex 仅给出 unified diff patch
• 严禁对代码做任何真实修改（使用 sandbox="read-only"）
• 获取原型后，以此为逻辑参考，重写为企业生产级代码
• 确保可读性极高、可维护性极高后，才能实施具体编程修改

3. 代码 Review

无论何时，只要完成切实编码行为后，必须立即使用 codex review 代码改动和对应需求完成程度。

4. 争辩与完善

• codex 只能给出参考，你必须有自己的思考
• 需要对 codex 的回答提出质疑
• 通过不断争辩以找到通向真理的唯一途径
• 最终使命是达成统一、全面、精准的意见

Codex MCP 工具调用规范

工具参数

必选参数：

• PROMPT (string): 发送给 codex 的任务指令
• cd (Path): codex 执行任务的工作目录根路径

可选参数：

• sandbox (string): 沙箱策略
  • "read-only" (默认): 只读模式，最安全
  • "workspace-write": 允许在工作区写入
  • "danger-full-access": 完全访问权限
• SESSION_ID (UUID | null): 用于继续之前的会话以与 codex 进行多轮交互，默认为 None（开启新会话）
• skip_git_repo_check (boolean): 是否允许在非 Git 仓库中运行，默认 False
• return_all_messages (boolean): 是否返回所有消息（包括推理、工具调用等），默认 False

返回值：

// 成功时
{
  "success": true,
  "SESSION_ID": "uuid-string",
  "agent_messages": "agent回复的文本内容",
  "all_messages": []
}

// 失败时
{
  "success": false,
  "error": "错误信息"
}

使用方式

开启新对话：

• 不传 SESSION_ID 参数（或传 None）
• 工具会返回新的 SESSION_ID 用于后续对话

继续之前的对话：

• 将之前返回的 SESSION_ID 作为参数传入
• 同一会话的上下文会被保留

调用规范

必须遵守：

• 每次调用 codex 工具时，必须保存返回的 SESSION_ID，以便后续继续对话
• cd 参数必须指向存在的目录，否则工具会静默失败
• 严禁 codex 对代码进行实际修改，使用 sandbox="read-only" 以避免意外
• 要求 codex 仅给出 unified diff patch

推荐用法：

• 如需详细追踪 codex 的推理过程和工具调用，设置 return_all_messages=True
• 对于精准定位、debug、代码原型快速编写等任务，优先使用 codex 工具

注意事项

会话管理

• 始终追踪 SESSION_ID，避免会话混乱
• 多轮对话时必须传递正确的 SESSION_ID

工作目录

• 确保 cd 参数指向正确且存在的目录
• 路径错误会导致工具静默失败

错误处理

• 检查返回值的 success 字段
• 处理可能的错误情况

协作原则

• codex 提供参考，你必须独立思考
• 通过争辩达成共识，而非盲从
• 最终目标是统一、全面、精准的解决方案