codex专业子代理
Codex CLI（MCP服务器）的工件首个子代理委托。
此仓库提供了一个本地（stdio）MCP服务器，它公开了：
delegate_autopilot--决定是否委派，如果是，则编排一个或多个codex exec子代理运行delegate_run--通过以下方式运行单个专业子代理codex execdelegate_resume--通过以下方式恢复之前的子代理线程codex exec resume
每个工具调用都会在下写入一个运行目录 ${CODEX_HOME:-$HOME/.codex}/delegator/runs// 包含提示、选定技能、事件流和结构化结果（工件优先调试）。
何时使用
- 您希望多步骤/跨领域工作具有并行性和专业性。
- 您需要持久的工件（日志+输出）来调试和查看发生的事情。
需求
- Node.js
>=20（参见package.json#engines) npmmise（推荐）：从以下位置安装固定运行时mise.tomlcodexPATH上的CLI并经过身份验证（真实委派运行所需）
可选：
- Python 3（仅适用于以下辅助脚本
.agent/)
安装并快速启动（从源代码）
从repo根目录（安装deps+构建 dist/):
# Recommended: install the pinned runtime (see mise.toml)
mise install
# Drift check (lockfiles + pins)
./toolchain-check.sh
# Install deps from lockfile
npm ci
# Build
npm run build配置Codex（推荐，防止超时）
委托运行可能需要几分钟。在Codex配置中将此服务器的MCP工具超时设置为1200秒（20分钟）($HOME/.codex/config.toml):
mkdir -p "$HOME/.codex"
cat >> "$HOME/.codex/config.toml" `).如果要手动运行的默认值，请设置 `CODEX_DELEGATE_REASONING_EFFORT` 在MCP服务器进程上（仅适用于以下情况 `reasoning_effort` 省略并且 `config_overrides` 尚未设置 `model_reasoning_effort`).
## 技能
子代理运行可以从以下位置加载Codex技能：
- 回购本地 `.codex/skills` （被委托人的最近祖先 `cwd`)
- 全球 `${CODEX_HOME:-$HOME/.codex}/skills`
注意：此回购 `delegation-autopilot` 技能已标记 `delegator_exclude: true` （仅限父级）以防止委托递归。
## 工件（运行目录）
每个工具调用都会在下写入一个运行目录 `${CODEX_HOME:-$HOME/.codex}/delegator/runs//`.
## 文档
开始 `docs/README.md` （索引），则：
- `docs/usage.md` --如何有效地使用工具
- `docs/troubleshooting.md` --常见故障模式（超时、丢失 `codex`等等）
- `docs/development.md` --本地开发和测试矩阵
- `docs/reference/tools.md` --全工具模式（输入/输出）
- `docs/reference/run-directories.md` --运行目录布局和工件含义
## 发展
npm test npm run lint npm run dev
集成测试（需要Codex CLI+身份验证）：
RUN_CODEX_INTEGRATION_TESTS=1 npm test
贡献： `CONTRIBUTING.md`.
## 安全
- 不要泄露秘密(`.env` 被忽视；使用 `.env.example` 作为模板）。
- 运行目录可以包含敏感的提示/输出；对待 `${CODEX_HOME:-$HOME/.codex}/delegator/runs` 敏感。
报告： `SECURITY.md`.
## 许可证
麻省理工学院