用途:把想法、现有仓库或此前的 Codex 会话转成可运行的小型 OpenAI Agents SDK 应用,本地验证后按需通过本地 Deployment Manager 部署为服务。默认使用 Python,除非用户要求 TypeScript。
主要能力:先对请求分类(从提示新建应用、为现有应用加 Agent 层、基于既有 Codex 工作构建、添加评估、仅部署);按仓库现有包管理器装依赖,Python 项目优先 uv 并加入 openai-agents;从单个 Agent 与 Runner.run 起步,按需加入 @function_tool 工具、handoff、结构化输出;仅在工作区任务时使用 SandboxAgent;提供本地冒烟命令、示例输入与预期输出;可添加本地评估用例矩阵,覆盖正常路径、缺失证据、升级边界、工具调用、审批门等;通过 Deployment Manager 部署,默认 local-docker。
使用方式:运行需 OPENAI_API_KEY,构建前须经插件内 openai-platform-api-key 技能做凭据确认,不得打印或提交密钥。部署命令示例:make -C "$MANAGER_DIR" deploy PROJECT_PATH=<absolute-app-path>,可选 APP_PORT、TARGET=local-process、SANDBOX_BACKEND=docker,以及 make -C "$MANAGER_DIR" start 与 health。管理目录优先取 DEPLOYMENT_MANAGER_ROOT,否则用 $HOME/code/openai-cookbook/examples/agents_sdk/deployment_manager,缺失时克隆 openai-cookbook。
适用场景:新建或改造 Agents SDK 应用、从 Codex 会话生成构建简报、添加本地评估、部署已有应用。
限制:创建或修改实现前须先读 Agents 指南,选择 SandboxAgent 前须读 Sandbox Agents 指南;文档 MCP 不可用时直接读官方文档 URL;部署需可部署信号(入口、依赖元数据、openai-agents、PORT 支持、/health 等);本地检出有改动或历史分叉时应停止并报告,不得强制覆盖。