Codex 编码代理
委派编码任务给 OpenAI Codex CLI（功能开发、PR 审查）
使用场景
用户希望将 Codex 用作真正的编码代理，而非通用的聊天助手：检查仓库、进行有边界的编辑、运行审查模式、恢复工作、安全使用 MCP，或带着清晰的验证证据交接工作。
当难点不是「编写代码」而是「让 Codex 安全且可预测地运作」时使用本技能，涵盖 CLI、exec、review、resume、MCP、应用服务器、云端任务或本地 OSS 提供方工作流。
架构说明
记忆保存在 ~/codex/ 中。如果 ~/codex/ 不存在，请运行 setup.md。结构请参阅 memory-template.md。
~/codex/
|-- memory.md # Durable activation boundaries and operating defaults
|-- repo-profiles.md # Per-repo conventions, test surface, and blast-radius notes
|-- safety.md # Sandbox, approval, and trust defaults
|-- mcp-notes.md # Approved MCP servers, scopes, and rejection reasons
`-- incidents.md # Stuck sessions, failed commands, and recovery patterns
快速参考
只需加载解决当前阻塞问题所需的最小文件。
| 主题 | 文件 |
| 设置指南 | `setup.md` |
| 记忆模板 | `memory-template.md` |
| 安装、登录与首次运行检查 | `install-and-auth.md` |
| 仓库执行与 `codex exec` 工作流 | `repo-execution.md` |
| 审批模式与沙箱选择 | `approvals-and-sandbox.md` |
| MCP、应用服务器、云端与本地提供方护栏 | `mcp-and-cloud.md` |
| 审查模式与交接模式 | `review-and-handoffs.md` |
| 认证、卡死会话与越权操作的恢复手册 | `troubleshooting.md` |
Requirements
codex 二进制已安装在目标机器上并能正常运行。
当选择该模式时，需通过 codex login 或显式 OPENAI_API_KEY 流程保持有效认证。
当任务涉及仓库检查、diff 审查或提交就绪工作流时，需具备 git。
在危险的沙箱绕过、远程 MCP 使用、Codex Cloud 应用、生产环境命令或任何具有不可逆副作用的操作之前，需获得用户明确批准。
将模型名称、功能和应用服务器行为视为实时产品形态：请用 codex --help、子命令帮助或官方文档验证，而不是固守过时的假设。
Operating Coverage
本技能将 Codex 视为可操作的编码工作台，而非泛泛的 AI 建议。涵盖内容包括：
交互式 Codex CLI 使用，并明确工作目录与安全选项
非交互式 codex exec 与 codex review 工作流
resume、fork 及便于交接的会话恢复
按影响范围选择沙箱与审批策略
MCP 服务器信任决策及本地与远程工具边界
仅在明确其额外信任与审查要求时，才使用 Codex 应用服务器与云端任务
当用户有意进行本地执行时，通过 --oss 与 --local-provider 路由到本地 OSS 提供方
Data Storage
仅在 ~/codex/ 中保存持久的 Codex 操作上下文：
哪些仓库或工作区已获准供 Codex 使用
各任务类型的默认沙箱与审批姿态
首选执行方式：交互式 CLI、exec、review、云端或本地 OSS 提供方
已批准的 MCP 服务器及其各自的访问范围
针对目录错误、工作树脏乱、命令卡死或认证失效的常用恢复笔记
Core Rules
1. Preflight the Task Before Codex Acts
先锁定五个事实：目标仓库、当前目录、工作树脏乱状态、所需权限以及预期的验证结果。
若其中任何一项不明确，先暂停并解决，再以写入能力运行 Codex。
在陌生仓库中，「开始写代码」永远不应是第一步。
2. Choose the Operating Mode Explicitly
使用交互式 Codex 进行探索性仓库工作，使用 codex exec 进行有边界的非交互执行，使用 codex review 进行审查优先的任务。
如需恢复或分支先前的工作，优先使用 resume 或 fork，而不是从头重新描述整个上下文。
将云端、应用服务器和 MCP 辅助的运行视为具有各自风险的不同模式。
3. Match Sandbox and Approval to Blast Radius
只读适合检查、规划与低信任探索。
工作区写入（workspace-write）适合在已批准仓库中的常规本地编码。
完全访问或危险绕过属于特殊情况模式，需要明确的用户意图和外部沙箱方案。
不要为了便利而将高信任模式常规化。
4. Read the Repo Before Editing It
在提出编辑前，先检查目录树结构、git 状态、入口点、约定与测试范围。
当工作树已脏乱时，将用户改动与代理改动区分开，避免破坏性清理。
Codex 应适应仓库，而非将仓库强行套入通用工作流。
5. Keep Changes Reviewable and Scoped
倾向于最小 diff、针对性命令和明确的文件归属。
除非被要求，否则避免无关清理、试探性重构或「顺手」改动。
如果某个命令或编辑扩大了范围，立即停下并说明这种扩展。
6. Treat Auth, MCP, and Cloud as Trust Boundaries
工具可用并不意味着它已获批准。
启用每个 MCP 服务器前，先审查其范围、数据访问与副作用。
尽可能使用现有登录会话；未经用户明确意图，绝不从本地文件提取密钥。
在本地应用前先检查云端 diff。
7. Verify Outcomes and Leave a Handoff Trail
一次成功的 Codex 运行应以检查结束，而非仅以代码编辑结束。
报告哪些内容已更改、哪些已验证、哪些失败以及哪些仍存在风险。
对于中断或长时间运行的工作，留下清晰的检查点，使其他操作者无需猜测即可恢复。
Codex Traps
在错误的目录中运行 Codex -> 编辑会落到错误的仓库或超出预期范围。
将 workspace-write 视为无害 -> 它仍会写入真实文件并可能迅速扩大 diff。
在常规工作中使用 --dangerously-bypass-approvals-and-sandbox -> 便利会变成无法审查的风险。
因为 MCP 服务器可用就启用 -> 隐藏的数据触达与副作用会悄然扩大。
未审查 diff 就应用云端输出 -> 本地仓库改动变得不透明。
让 Codex 在脏乱的工作树中工作却未明确归属 -> 带来审查噪音与意外覆盖风险。
中断后重新运行含糊的提示 -> 导致重复工作与不一致的验证。
External Endpoints
除用户明确批准更多之外，仅允许以下外部类别：
| 端点 | 发送的数据 | 用途 |
| https://api.openai.com | 提示词、所选仓库上下文、工具结果以及 Codex 运行所需的执行元数据 | Codex 模型执行、云端任务、与登录关联的代理工作 |
| https://developers.openai.com/* | 仅文档查询 | 验证当前 Codex 产品行为与配置细节 |
| https://{user-approved-mcp-host} | 特定 MCP 服务器所需的请求负载 | 本地机器之外的可选用户批准工具访问 |
除非用户明确批准额外的 MCP 服务器、Git 远程仓库或服务端点，否则不会向外部发送其他数据。
安全说明与隐私
会离开您机器的数据：
发送给 OpenAI 服务的 Codex 运行提示词与所选仓库上下文
仅用于用户已批准 MCP 服务器的可选 MCP 负载
有意使用 Codex Cloud 时的可选云端任务负载与 diff
留在本地的数据：
~/.codex/config.toml 及用户的本地 Codex 会话/配置状态
~/codex/ 下的持久操作笔记
本地 diff、验证输出与仓库元数据（除非用户明确推送或上传）
本技能绝不会：
默认认为危险绕过是可接受的
静默启用远程 MCP 或云端应用
从任意文件中提取令牌来「帮助」认证成功
向用户隐瞒沙箱或审批选项
声称 CLI、应用服务器、云端与本地 --oss 流程具有相同的风险
Trust
使用本技能后，Codex 工作可能将提示词和所选仓库上下文发送给 OpenAI，以及任何用户批准的可选 MCP 端点。
仅当您信任这些服务处理这些数据时才安装。
Scope
本技能只负责：
帮助在真实编码环境中安全有效地操作 Codex
将仓库工作组织为明确的执行、审查与交接模式
为已批准仓库、安全姿态与常见恢复模式保留持久记忆
本技能绝不：
将每个可用的 Codex 功能视为自动获批
推荐将破坏性 git 清理作为默认修复手段
模糊仅本地、云端与 MCP 辅助执行之间的界限
修改自身的技能文件
相关技能
如用户确认，可使用 clawhub install 安装：
agentic-engineering —— 强化围绕并行编码代理与影响范围思维的人机工作流。
coding —— 在 Codex 处于正确的仓库边界内运行时提升实现质量。
git —— 安全处理分支、diff 与非破坏性仓库恢复。
api —— 当 Codex 与服务集成时复用结构化 API 与请求调试模式。
workflow —— 将重复的 Codex 任务转化为可复现、可审查的执行路径。
Feedback
如果觉得有用：clawhub star codex
保持更新：clawhub sync
