核心用法
coding-lead 是一个面向实现型 Agent 的代码执行路由技能，核心功能是按任务复杂度分层调度：
| 复杂度 | 判定标准 | 执行策略 |
|--------|----------|----------|
| **Simple** | 单文件 <60 行，作用域清晰 | 当前会话直接执行 read/write/edit/exec |
| **Medium** | 2-5 文件，需后续跟进 | 优先 Claude ACP `mode:"run"` 或 direct acpx → 降级直接执行 |
| **Complex** | 多模块/架构级，需连续性 | 现有实现会话 + 上下文文件 + 序列化跟进，ACP 仅作辅助 |
关键机制：
- ACP 检测三阶降级：sessions_spawn → acpx CLI → 直接执行，30s 超时，会话级缓存
- 上下文文件生命周期：
<project>/.openclaw/context-<task-slug>.md，单项目活跃上限 60，总上限 100 - 内存集成：[smart-agent-memory] 前置召回相关决策，后置记录变更与教训
- 并行边界：硬上限 5 并发单元，禁止同代码链并行修改
显著优点
1. 生产级鲁棒性：ACP 是加速器而非硬依赖，任何环节故障均有无损降级路径
2. Token 效率优化：上下文文件存磁盘而非嵌入 Prompt，ACP 提示保持精简（任务+验收标准+文件路径）
3. Claude 专属深度优化：当前生产路径锁定 Claude-only，避免多 Agent 调度噪音
4. 复杂度自适应：「When in doubt, go one level up」原则防止低估任务
潜在局限
- Vendor Lock-in：当前仅支持 Claude，Codex 等未来 Agent 仅作预留
- 技术栈固化：新建项目默认 PHP(Laravel)/Vue/Flutter，偏离需显式确认
- 上下文文件治理成本：60/100 文件上限需主动清理，否则可能触及瓶颈
- ACP 状态无持久化：会话级缓存，新会话需重新检测
适合人群
- 使用 OpenClaw 框架的中大型开发团队
- 需要处理跨会话代码连续性的长期项目
- 对 ACP 可用性不确定、要求「失败即降级」的生产环境
常规风险
| 风险场景 | 缓解措施 |
|----------|----------|
| ACP 超时/无响应 | 30s 硬性超时 + 自动降级 |
| 上下文文件膨胀 | 100 文件上限 + 自动归档机制 |
| 并发冲突 | 5 单元硬上限 + 禁止同链并行 |
| 目录误操作 | 禁止在 `~/.openclaw/` 内 spawn，强制显式 `cwd` |
| 隐蔽失败 | 「Never silently fail」原则，强制完成或显式报告 |