majiayu000 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 仓库中运行，默认Falsereturn_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 提供参考，你必须独立思考
- 通过争辩达成共识，而非盲从
- 最终目标是统一、全面、精准的解决方案