核心用法
Coding-lead 是一个面向全栈开发任务的代码执行技能,核心在于按复杂度分级路由:
| 级别 | 标准 | 执行路径 |
|------|------|----------|
| 简单 | 单文件 <60 行 | 直接执行(read/write/edit/exec) |
| 中等 | 2-5 文件,有后续问题 | 优先 Claude ACP `mode:"run"` 或直接 acpx |
| 复杂 | 多模块、架构级、需连续性 | 现有 fullstack-dev 会话 + 上下文文件 + 直接执行 |
关键设计原则:ACP 是加速器而非硬依赖,不可用时不阻塞;工具检测一次后缓存;上下文文件存于磁盘而非提示词以节省 token。
显著优点
1. 弹性架构:三级回退机制(ACP spawn → acpx CLI → 直接执行),任何环节故障不中断工作流
2. 成本优化:简单任务避免 ACP 开销,中等任务用一次性 run 而非持久会话,复杂任务才启用会话连续性
3. 上下文管理:磁盘持久化的上下文文件(<project>/.openclaw/context-<task>.md)支持跨会话记忆,Claude Code 自动读取项目级标准(CLAUDE.md),OpenClaw 加载团队级标准
4. 并行控制:硬上限 5 个并发单元,明确定义边界(项目/模块/阶段/负责人),防止冲突
5. 智能集成:可选调用 smart-agent-memory(长期记忆)、qmd(代码检索),失败有降级方案
潜在缺点与局限
- Claude 单一依赖:当前生产路径仅支持 Claude ACP,Codex 等其他代理处于"未来可能"状态
- 上下文文件上限:单项目 60 个活跃 + 100 个总计的限制可能在超大型长期项目中成为瓶颈
- 超时保守:ACP 检测各阶段仅 30 秒,网络波动或冷启动可能导致误判为不可用
- 无自动合并策略:并行任务的合并与验收负责人需人工前置定义,缺乏自动化冲突解决
- 技术栈偏置:PHP/Laravel + Vue.js + Flutter 的优先推荐可能与新项目实际需求错位
适合人群
- 多项目并行团队:需要上下文隔离与记忆延续的中小技术团队
- 追求成本效率的开发者:希望自动区分"值得 ACP 开销"与"直接搞定"的场景
- 已有 OpenClaw 生态用户:配合 smart-agent-memory、qmd 工具链使用体验最佳
常规风险
| 风险场景 | 缓解措施 |
|----------|----------|
| ACP 误判为不可用 | 缓存会话级结果,故障时重新检测 |
| 上下文文件堆积 | 任务完成及时归档/删除,近上限时主动清理 |
| 并行边界模糊 | 默认回退串行,模糊时不并行 |
| 配置目录误操作 | 禁止在 `~/.openclaw/` 内 spawn,强制显式设置 cwd |
| 代理无限循环 | 最大 3 次智能重试后强制降级或上报 |