核心功能
acpx v4.0 是一款面向终端的 AI Agent 编排工具（CLI wrapper），旨在简化多智能体协同工作。核心能力包括：
- Agent 发现与健康检查：自动识别已安装的代码智能体（如 OpenCode、Claude、Kimi 等），并提供统一健康检测入口
- 执行模式：支持单 Agent 运行（
run）、并行执行（parallel，适用于独立任务）、顺序批处理（batch，适用于依赖任务） - 工作流预设：内置
review（代码审查）、refactor（安全重构）、test（生成测试）、debug（深度调试）四种常用流水线 - OpenClaw 集成：可通过
sessions_spawn在子代理环境中调用，支持 JSON 输出便于下游处理
显著优点
1. 统一接口：将多个异构 AI CLI（opencode、pi、kilo、codex、claude 等）抽象为一致命令集
2. 并行效率：parallel 模式可同时启动多个独立任务，显著缩短总耗时
3. 安全导向设计：refactor 工作流强制生成 diff，debug 设置 600s 超时防止无限循环
4. 轻量可扩展：MIT 协议，支持自定义 batch 文件格式与 workflow 扩展
潜在局限
- 依赖外部二进制：需预先安装各 Agent CLI（opencode、pi 等），本身不提供 AI 能力
- 并行任务独立性要求：使用者需自行判断任务是否真正独立，误用可能导致竞态问题
- 社区维护：作者为个人开发者（qriiz112），长期维护能力存疑
- 文档覆盖有限：复杂错误处理、Agent 间状态共享机制未详细说明
适合人群
- 已使用多种 AI 编程工具（Claude Code、Kimi、OpenCode 等）的开发者
- 需要批量执行代码审查、测试生成的 DevOps/SRE 工程师
- 希望将 AI Agent 集成到 CI/CD 或自动化脚本的技术团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 命令注入 | `exec` 和 batch 文件直接传递参数至底层 Agent，需确保输入可信 |
| 并行资源争抢 | 同时运行多个 Agent 可能耗尽 API 配额或本地资源 |
| 工作流误用 | `parallel` 用于依赖任务会导致不可预期结果 |
| 子代理权限 | 通过 OpenClaw 调用时继承父级权限，需遵循最小权限原则 |
建议用法
# 首次使用：检查环境 acpx discover && acpx health # 日常代码审查 acpx workflow review # 批量独立任务（确认无依赖） acpx parallel tasks.txt