Codex MCP 开发

通过位于 {baseDir}/scripts/codex_mcp.py 的包装脚本使用本地 Codex 安装。
这提供了一个稳定的路径：

OpenClaw → mcporter → codex-mcp-server → 本地 codex

快速设置

首先安装必备组件：

• mcporter
• 本地 codex
• codex-mcp

如果 config/mcporter.json 尚不存在，请创建项目 MCP 条目：

mcporter config add codex-cli --scope project --command codex-mcp

此技能期望存在一个名为 codex-cli 的工作区本地 MCP 服务器。

工作流程

1. 将此技能用于非平凡的编码任务。
2. 如果这是会话中的首次使用或某些内容看起来有问题，请运行：
   • python3 {baseDir}/scripts/codex_mcp.py doctor
3. 选择一种模式：
   • 分析 / 规划 / 解释： 使用 ask 而不带 --full-auto
   • 实现 / 重构 / 编写测试： 使用 ask --full-auto
4. 始终将 --cwd 设置为目标仓库或项目目录。
5. 给 Codex 一个具体的提示，包含文件、约束和验收标准。
6. 在 Codex 响应后，自己检查文件并运行本地测试，而不是盲目信任工具的输出。
7. 总结更改、已运行的测试以及任何剩余的风险。

适用场景

• 在多个文件中实现功能
• 在真实的仓库上下文中修复错误
• 在约束条件下进行重构
• 编写或更新测试
• 调试失败的命令或堆栈跟踪
• 要求本地 Codex 进行第二次实现传递或审查

命令模式

健康检查

python3 {baseDir}/scripts/codex_mcp.py doctor

版本信息

python3 {baseDir}/scripts/codex_mcp.py version

普通实现

python3 {baseDir}/scripts/codex_mcp.py ask \
  --cwd /absolute/path/to/repo \
  --full-auto \
  --prompt "实现所需的更改，更新测试，并总结更改内容。"

只读分析

python3 {baseDir}/scripts/codex_mcp.py ask \
  --cwd /absolute/path/to/repo \
  --sandbox-mode read-only \
  --approval-policy never \
  --prompt "解释错误，识别可能的根本原因，并提出最小安全修复方案。"

从文件读取长提示

python3 {baseDir}/scripts/codex_mcp.py ask \
  --cwd /absolute/path/to/repo \
  --full-auto \
  --prompt-file /tmp/codex-task.txt

提示规则

尽可能包含以下内容：

• 目标文件或目录
• 期望的行为
• 确切的错误消息或失败的测试
• 范围约束
• 所需的测试更新
• 期望的输出格式

优先使用如下提示：

• “修复 tests/api.test.ts 中失败的测试，不要更改公共行为。运行相关测试并总结根本原因。”
• “重构 src/cache.py 以提高可读性，保持行为不变，并为 TTL 边缘情况添加回归测试。”
• “审查 server/ 中的认证流程，找出前 3 个正确性风险，并提供具体的文件引用。”

防护措施

• 对于普通的实现工作，优先使用 --full-auto。
• 不要使用 --yolo，除非用户明确要求激进执行。
• 使用特定于仓库的 --cwd；不要在错误的目录上运行。
• 在可能的情况下，通过本地读取/测试进行验证。
• 如果任务非常小或仅需微调，跳过此技能直接编辑。