核心用法
Coding Lead 是一套分级任务路由的代码执行框架,专为全栈开发场景设计:
| 复杂度 | 判定标准 | 执行策略 |
|--------|----------|----------|
| **Simple** | 单文件<60行、局部作用域清晰 | 直接执行(read/write/edit/exec),不启ACP |
| **Medium** | 2-5文件、范围明确、可能有后续问题 | 优先 Claude ACP `mode:"run"` 或直接 acpx → 降级直接执行 |
| **Complex** | 多模块、架构级、需连续性 | 复用现有 fullstack-dev 会话 + 上下文文件 + 直接执行,不依赖ACP会话持久化 |
关键机制:
- ACP三级检测:
sessions_spawn→acpx CLI→direct,30秒超时自动降级 - 上下文文件生命周期:
<project>/.openclaw/context-<task-slug>.md,活跃上限60个/项目,总计上限100个 - 双层编码标准:项目级(Claude Code 自动读取 CLAUDE.md)与团队级(OpenClaw 加载 tech-standards.md),ACP任务不重复嵌入标准
显著优点
1. 弹性架构:ACP作为加速器而非硬依赖,任何层级失败均可无缝降级至直接执行
2. Token优化:磁盘上下文文件替代Prompt嵌入、lean prompt策略、qmd精准代码检索,显著降低LLM调用成本
3. 连续性保障:复杂任务通过"现有会话+上下文文件+串行跟进"保持状态,避免IM线程绑定ACP session的可靠性风险
4. 并行可控:硬性边界(≤5并发单元、模块隔离、明确合并/验收责任人)防止冲突
潜在局限
- Claude-only限制:当前仅支持Claude作为ACP执行代理,Codex等未来代理未纳入生产路径
- 路径依赖:新项目的PHP(Laravel/ThinkPHP)+Vue+Flutter技术栈偏好可能需要团队磨合
- 上下文管理复杂度:60/100文件上限需主动清理,否则面临归档/合并决策负担
- ACP不稳定时的延迟:检测超时(30s×2=60s)在紧急场景可能感知明显
适合人群
- 多项目并行的全栈团队:需在不同技术栈间快速切换,同时保持代码质量一致性
- 追求成本效益的中小团队:通过分级路由避免为简单任务支付ACP/session开销
- 重视可追溯性的工程文化:强制上下文文件+记忆整合,适合有代码审查、知识沉淀需求的组织
常规风险
| 风险场景 | 缓解措施 |
|----------|----------|
| ACP检测失败导致阻塞 | 显式降级规则,永不静默失败 |
| 上下文文件膨胀失控 | 100文件硬性上限+自动清理策略 |
| 并行冲突 | 模块边界+单一责任原则,模糊边界强制串行 |
| 误写 ~/.openclaw/ | 强制cwd验证+显式项目目录参数 |
| 密钥硬编码 | 内置规则禁止,依赖团队级安全标准 |
安全等级S:无网络外泄风险、本地文件操作有边界检查、降级机制完备,但需注意acpx/sessions_spawn的命令注入防护依赖底层运行时安全。