扩展机制与外部工具集成

到了大师级，你会想把 Codex 接进自己的工具链：外部脚本、内部系统、自定义工作流。本节讲扩展机制的通用思路，具体接口以官方文档为准，重点是建立"哪些能接、怎么接才稳"的判断。

一、扩展的两个方向

让代理调用外部能力。通过脚本、命令行工具或标准接口，让它在执行过程中触达你的内部系统（如查内部文档、触发构建、读监控数据）。关键是把这些能力包装成"输入明确、输出稳定、可重复"的命令，代理才好用。

把代理嵌入自动化。用非交互模式在脚本、CI、定时任务里调用它，让它承担重复性的机械工作（如批量修 lint、生成 changelog、根据 issue 起草稿）。这部分更适合交给保守沙箱 + 门禁把关。

二、扩展的稳定性原则

• 接口要小而稳。别让扩展依赖界面细节，命令行和文件接口比 UI 操作稳定。
• 失败要可观测。外部调用失败时要有明确报错和日志，不能静默失败。
• 权限要最小。扩展只拿它完成任务所需的最小权限，尤其生产环境。

三、别过度工程

扩展是为了把重复工作自动化，不是为了炫技。先用手动方式把一件事做顺、做稳定，确认它确实高频重复，再把它自动化。过早自动化一个你还没摸清的流程，只会把混乱也一起自动化。