Codex — 代码库

当用户希望将 Codex 用作真正的编码代理，而不是通用的聊天助手时：检查仓库，进行有界编辑，运行审查模式，恢复工作，安全使用 MCP 或将工作移交给他人，并提供明确的验证证据。使用此技能时，困难的部分不是“编写代码”，而是使 Codex 在 CLI、exec、审查、恢复、MCP、app-server、云任务或本地 OSS 提供商工作流中“安全且可预测地”运行。

架构 内存存储在 ~/codex/ 中。如果 ~/codex/ 不存在，请运行 setup.md。有关结构，请参阅 memory-template.md。 ~/codex/ |-- memory.md # 持久激活边界和操作默认值 |-- repo-profiles.md # 每个仓库的约定、测试表面和爆炸半径注释 |-- safety.md # 沙盒、批准和信任默认值 |-- mcp-notes.md # 批准的 MCP 服务器、范围和拒绝原因 `-- incidents.md # 卡住的会话、失败的命令和恢复模式

快速参考 仅加载解决当前阻塞器所需的最小文件。 主题 文件 设置指南 setup.md 内存模板 memory-template.md 安装、登录和首次运行检查 install-and-auth.md 仓库执行和 Codex exec 工作流 repo-execution.md 批准模式和沙盒选择 approvals-and-sandbox.md MCP、app-server、云和本地提供商的防护 mcp-and-cloud.md 审查模式和移交模式 review-and-handoffs.md 用于身份验证、卡住的会话和错误范围工作的故障排除手册 troubleshooting.md

要求 在目标机器上安装并正常运行 codex 二进制文件。 通过 codex 登录或显式 OPENAI_API_KEY 流程进行活动身份验证，当选择此模式时。 当任务涉及仓库检查、差异审查或提交就绪工作流时，需要 git。 在绕过沙盒、远程 MCP 使用、Codex Cloud 应用、生产命令或任何具有不可逆转副作用的操作之前，需要显式用户批准。 将模型名称、功能和 app-server 行为视为实时产品表面：使用 codex --help、子命令帮助或官方文档进行验证，而不是硬编码过时的假设。

操作覆盖 此技能将 Codex 视为操作编码表面，而不是通用的 AI 建议。它涵盖： 具有显式工作目录和安全选择的交互式 Codex CLI 使用 非交互式 codex exec 和 codex review 工作流 resume、fork 和移交友好会话恢复 沙盒和批准策略选择，按爆炸半径 MCP 服务器信任决策和本地与远程工具边界 仅在其额外信任和审查要求明确时使用 Codex app-server 和云任务 当用户故意希望本地执行时，通过 --oss 和 --local-provider 使用本地 OSS 提供商路由

数据存储 仅在 ~/codex/ 中存储持久的 Codex 操作上下文： 已批准用于 Codex 的仓库或工作空间 每种任务类型的默认沙盒和批准姿态 首选的执行表面：交互式 CLI、exec、review、云或本地 OSS 提供商 已批准的 MCP 服务器及其允许的内容 有关错误目录、脏工作树、停滞命令或破坏身份验证的重复恢复注释

核心规则

• 在 Codex 执行之前预飞任务

先锁定五个事实：目标仓库、当前目录、脏工作树状态、所需权限和预期验证。如果其中任何一个不清楚，请在运行具有写入功能的 Codex 之前暂停并解决它们。 “开始编码”永远不是不熟悉的仓库中的第一步。

• 显式选择操作模式

使用交互式 Codex 进行仓库探索工作，使用 codex exec 进行有界非交互式执行，使用 codex review 进行审查优先任务。如果正在恢复或分叉先前的工作，请更喜欢 resume 或 fork，而不是从头描述整个上下文。 将云、app-server 和 MCP 辅助运行视为具有单独风险的单独模式。

• 将沙盒和批准与爆炸半径匹配

只读适用于检查、规划和低信任探索。工作空间写入适用于正常的本地编码，批准的仓库。完全访问或危险绕过是需要显式用户意图和外部沙盒故事的特殊情况模式。不要为了方便而规范化高信任模式。

• 在编辑之前阅读仓库

在提议编辑之前，检查树形、git 状态、入口点、约定和测试表面。当工作树已经脏时，将用户更改与代理更改分开，并避免破坏性清理。Codex 应该适应仓库，而不是强制仓库进入通用工作流。

• 保持可审查的更改和范围

偏爱最小的差异、有针对性的命令和显式的文件所有权。避免无关的清理、推测性的重构或“同时”编辑，除非请求。如果命令或编辑扩大范围，请立即停止并显示该扩展。

• 将身份验证、MCP 和云视为信任边界

工具的可用性并不意味着它已被批准。在启用它之前，审查每个 MCP 服务器的范围、数据访问和副作用。使用现有的登录会话...