mcpField
C
codex

codex

github.com/longranger2Agent 工作流81250 次安装18 周前更新
代码仓库

关于 codex

通过随附的 shell 脚本将编码任务委派给 Codex CLI 的技能，提供提示词组织、文件上下文、后续会话及审查变更的操作指导。

主要功能

  1. 01通过随附 shell 脚本委派任务
  2. 02工作区与文件上下文选项
  3. 03使用会话 ID 继续对话
  4. 04只读讨论模式
  5. 05审查代码变更的指导

适用场景

  1. 01执行已明确的编码计划
  2. 02协调修改多个文件
  3. 03批量重构或生成代码
  4. 04在不修改工作区时请求分析

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/longranger2/claude-gpt-workflow --skill codex

安装后在 Claude Code 中输入/codex确认已加载。

附带文件.gitignorescripts/ask_codex.sh

详细介绍

CodeX — 你的 Codex 编码搭档

将编码任务委托给 Codex CLI。CodeX 将清晰的计划转化为可运行的代码。

关键规则

  • 只能通过随附的 shell 脚本与 CodeX 交互。绝不要直接调用 codex CLI。
  • 每项任务只运行脚本一次。如果成功（退出码为 0），请读取输出文件并继续。不要重新运行或重试。
  • 不要读取或检查脚本源代码。将其视为黑盒。
  • 传递包含方括号、空格或特殊字符的文件路径时，务必加引号（例如 --file "src/app/[locale]/page.tsx"）。未加引号的 [...] 会触发 zsh 通配符扩展。
  • 让任务提示词聚焦。 尽量控制在约 500 个词以内。描述要做什么以及关键约束，而不是逐步说明如何做。CodeX 是一个拥有完整工作区访问权限的自主 Agent，会自行读取文件、探索代码并找出实现细节。
  • 切勿将文件内容粘贴到提示词中。 使用 --file 将关键文件路径提供给 CodeX，它会直接读取文件。在提示词中重复文件内容会浪费 token，没有任何价值。
  • 不要在提示词中提及或描述 SKILL.md 本身。 CodeX 无需了解此技能的配置。

如何调用脚本

脚本路径为：

~/.claude/skills/codex/scripts/ask_codex.sh

最简调用：

~/.claude/skills/codex/scripts/ask_codex.sh "Your request in natural language"

提供文件上下文：

~/.claude/skills/codex/scripts/ask_codex.sh "Refactor these components to use the new API" \
  --file src/components/UserList.tsx \
  --file src/components/UserDetail.tsx

多轮对话（继续之前的会话）：

~/.claude/skills/codex/scripts/ask_codex.sh "Also add retry logic with exponential backoff" \
  --session <session_id from previous run>

脚本成功时会输出：

session_id=<thread_id>
output_path=<path to markdown file>

读取 output_path 指向的文件以获取 CodeX 的回复。如果计划后续调用，请保存 session_id。

决策准则

满足以下任一条件时调用 CodeX：

  • 实施计划明确，需要执行编码任务。
  • 任务涉及批量重构、代码生成或重复性修改。
  • 需要按照既定模式协调修改多个文件。
  • 希望从实践者的角度判断计划是否可行。
  • 任务对成本敏感，且不需要深入的架构推理。
  • 根据现有代码编写或更新测试。
  • 根因已明确的简单到中等难度的 Bug 修复。

工作流

  1. 设计解决方案并确定涉及的关键文件。
  2. 使用清晰、简洁的任务描述运行脚本。告诉 CodeX 目标和约束，而不是逐步说明实现细节——它会自行判断。若要讨论，请使用面向问题的任务，并添加 --read-only。
  3. 使用 --file 传入相关文件（2–6 个高信号入口文件；CodeX 拥有完整工作区访问权限，会自行发现相关文件）。
  4. 阅读输出——CodeX 会执行修改并报告所做的工作。
  5. 在工作区中检查修改。

对于多步骤项目，使用 --session <id> 继续对话，并保留完整的对话历史。对于相互独立的并行任务，使用 run_in_background: true 的 Task 工具。

选项

  • --workspace <path> — 目标工作区目录（默认为当前目录）。
  • --file <path> — 指定关键入口文件（可重复使用，路径相对于工作区或为绝对路径）。不要在提示词中重复文件内容。
  • --session <id> — 恢复之前的会话，以进行多轮对话。
  • --model <name> — 覆盖模型（默认使用 Codex 配置）。
  • --reasoning <level> — 推理力度：low、medium、high（默认：medium）。代码审查、调试、复杂重构或根因分析时使用 high。
  • --sandbox <mode> — 覆盖沙盒策略（默认通过 full-auto 使用 workspace-write）。
  • --read-only — 只读模式，用于纯讨论或分析，不修改文件。

评论

支持 Markdown