SuperAPI AI 工具集

codex

编程与开发

查看项目

更新于 10-16 17:29

技能介绍

用途

Codex 是一项独立的交接技能(handoff skill),用于从 Claude Code 中将工作委派给 OpenAI Codex CLI。它明确说明这是 JMO 的独立交接技能,并非 gstack 的 /codex 技能,也不依赖 gstack。适用场景是用户要求把限定范围的任务——如实现、代码审查或技术二次意见——交给 Codex 处理。

主要能力

  • 在交接前检查环境:检查 command -v codex 与 codex exec --help。若缺失,引导用户访问 https://developers.openai.com/codex/cli/ ,并说明用户必须安装并登录 Codex。若 CLI 不可用,不得声称已运行交接。
  • 读取仓库说明并检查 git status --short,识别工作目录、请求模式(review、advice 或 implementation)、允许的文件以及验收标准。当请求未授权编辑时,默认采用只读审查。
  • 撰写聚焦提示词,包含用户任务、相关路径、约束与必需检查,并提供足够上下文供另一个代理使用,同时不传递凭据或无关私有材料。告知 Codex 哪些文件已被修改,并保留这些更改。

使用方式

使用用户配置的模型,通过 stdin 或带引号的 heredoc 传递提示词,而不是插值 shell 文本。将示例目录替换为实际项目绝对路径,例如:

codex exec --sandbox read-only --cd '/absolute/project/path' - <<'TASK'
Review the specified changes. Do not edit files. Report actionable findings with file locations, evidence, and uncertainty. Follow the repository's instructions.
TASK

对于获授权的实现,使用 --sandbox workspace-write,并在提示词中写明确切任务、允许的文件与验证标准。不要使用绕过审批或沙箱的标志。如果任务无法在当前权限下运行,需报告该限制。

等待完成并读取退出状态与输出。不要让 Claude 和 Codex 同时编辑同一文件。并行工作时,使用独立 worktree 和明确的文件归属,仅在审查结果更改后才整合。

核验与报告

审查时,检查被引用的代码并在将每项发现呈现为已确认之前进行评估。实现时,检查 diff 并运行相关检查。报告 Codex 更改或发现了什么、已验证的内容以及任何仍存在的失败。除非这是用户任务的一部分,否则不要自动提交、推送或部署。

任务参数以 $ARGUMENTS 传入。