Codeagent 多后端编排技能
通过 codeagent-wrapper 一条命令调用 Codex/Claude/Gemini/OpenCode 多个 AI 后端,完成代码分析、重构与多智能体并行任务编排。
SKILL.md 数据流透明,worktree 隔离、只读 agent 预设、显式 allowed/disallowed_tools 枚举均利于安全;但重大扣分项:--skip-permissions 选项存在且 CODEAGENT_SKIP_PERMISSIONS 默认 true、CODEX_BYPASS_SANDBOX 默认 true,属跳过用户确认和沙箱的危险默认值,缺回滚机制说明,故仅给中等分。
文档自洽,含退出码表、进度帧说明、失败输出格式、依赖拓扑排序与环检测;仓库 CI 覆盖 codeagent-wrapper 的 Go 测试。但按静态规则不高于 10:测试针对 wrapper 而非本 skill 关键路径,错误反馈质量未经执行验证。
使用场景、适用/不适用边界(只读 vs develop agent)、输入输出格式、触发条件描述较清晰;但核心依赖 Codex/Claude/Gemini/OpenCode 四个海外 CLI,在中国大陆网络可达性差,且无中文支持说明,扣分。
结构清晰、渐进披露良好(快速参考→详细模式),AGPL-3.0 许可明确,package. 有版本号 6.7.0;但 skill 本身无 changelog、无版本对应关系、无已知限制披露,发布者身份未经验证,维护责任仅隐含于仓库。
多后端编排、并行任务、会话恢复、结构化 JSON 输出等描述完整,核心价值主张合理;但静态审查无法验证输出可直接使用,也无代表性产出证据,且需用户预先安装四个外部 CLI,成本不低,扣分。
仓库含真实 CI(三平台矩阵测试)与 Go 测试套件,覆盖 skill 的核心依赖 codeagent-wrapper,可部分佐证;但按静态规则不高于 5,skill 自身路径无独立复现证据。
- CODEAGENT_SKIP_PERMISSIONS 与 CODEX_BYPASS_SANDBOX 默认均为 true,实际部署会跳过权限确认与沙箱,建议显式改为 false 并审查 --skip-permissions 使用场景。
- 核心功能依赖 Codex/Claude/Gemini/OpenCode 四个海外 CLI,中国大陆网络环境下基本不可直接使用,需自备代理或替代后端。
- 静态审查未执行任何代码:编排效果、失败反馈与输出质量均未经验证,敏感或生产环境使用前应先在隔离仓库小规模试运行。
- develop 类 agent 会直接修改代码并运行测试,建议始终配合 --worktree 使用以便回滚。
这个 Skill 能做什么,适合哪些场景?
codeagent 技能教 Claude Code 如何调用 codeagent-wrapper 命令行工具,把代码任务分发给四个可插拔后端(Codex、Claude、Gemini、OpenCode)。它支持代理预设(code-explorer、code-architect、code-reviewer、develop)、按项目文件自动注入语言最佳实践技能、git worktree 隔离,以及基于依赖拓扑排序的并行执行。默认后台运行,输出结构化 JSON 报告与会话 ID,可恢复续跑。该技能属于 stellarlinkco/myclaude 仓库,随整个技能集合以 AGPL-3.0 许可发布。
读取工作目录特征文件(go.mod、package. 等)自动选择要注入的技能;构造并执行 codeagent-wrapper 命令,指定后端、模型、推理强度和代理预设;通过 --parallel 从 stdin 读取任务配置,用 Kahn 算法做依赖排序并并发运行独立任务;在隔离的 git worktree(分支 do/{task_id})中执行写操作任务;生成每个任务的通过/失败报告、日志路径和结构化 JSON 输出,并返回可续跑的 SESSION_ID。
- 需要在同一项目里混合使用不同 AI 后端的开发者:算法难题交给 Codex,文档和提示工程交给 Claude,UI 原型交给 Gemini。
- 负责大型重构的工程师:先用 code-explorer 和 code-architect 只读分析,再用 develop 在 worktree 中安全实施改动。
- 希望并行走查多阶段流程(探索→设计→实现→评审)的团队负责人,通过依赖声明自动调度任务顺序。
- 维护多语言 monorepo 的开发者,利用自动检测让 Go/Rust/Python/前端项目各自注入对应最佳实践。
- 需要审计和留痕的自动化流水线,借助 --output 生成结构化 JSON 结果与日志文件。
这个 Skill 有哪些优点和局限?
- 一个入口统一四种后端,可按任务类型选择最合适的模型。
- 内置只读/可写代理预设和自动技能注入,减少手写提示词。
- 并行执行带依赖拓扑排序和循环依赖检测,独立任务自动并发。
- worktree 隔离和结构化 JSON 输出便于集成到现有自动化流程。
- 支持会话恢复,失败任务有独立日志便于排查。
- 依赖外部 codeagent-wrapper 二进制和至少一个后端 CLI,环境搭建成本高。
- 仓库未提供测试套件或独立的本技能使用证据,README 主要描述整个模块集合。
- AGPL-3.0 许可对商业闭源集成有传染性约束,商用需另行联系授权。
- 部分行为依赖 Claude Code 工作流约定(后台执行、Bash 工具参数),在其他客户端需自行调整。
- 源文档未提供版本号、稳定性保证或各后端的具体成本对比。
如何安装这个 Skill?
运行交互式安装器:npx github:stellarlinkco/myclaude(可用 --list 查看可装项,--install-dir 指定目录,--force 覆盖安装)。安装后 codeagent-wrapper 位于 ~/.claude/bin/,本技能文件位于 ~/.claude/skills/codeagent/。源文档未说明该技能可否脱离整个仓库单独安装的详细步骤。
如何使用这个 Skill?
基本调用:codeagent-wrapper --agent develop --skills golang-base-practices - . <<'EOF' …任务描述… EOF(推荐配合 Bash 工具后台执行)。并行模式:codeagent-wrapper --parallel <<'EOF',用 ---TASK---/---CONTENT--- 段定义 id、agent、dependencies 等字段。长任务会输出 [codeagent-progress] 帧,切勿中途杀进程;可用 resume <session_id> 续跑。配置可放 ~/.codeagent/config.(yaml||toml) 或用 CODEAGENT_ 前缀环境变量。