核心用法
coding-lead 是 fullstack-dev 角色的代码执行中枢，而非团队级任务路由层。它通过「复杂度分级 + 动态工具检测」决定最佳执行路径：
| 任务级别 | 判定标准 | 执行策略 |
|---------|---------|---------|
| **Simple** | 单文件 <60 行，作用域清晰 | 直接读写编辑执行，不启动 ACP |
| **Medium** | 2-5 文件，有后续跟进可能 | 优先 Claude ACP `mode: "run"` 单次运行，或 direct acpx |
| **Complex** | 多模块、架构级，需连续性 | 复用现有 fullstack-dev 会话 + 磁盘上下文文件 + 串行跟进 |
工具链检测（每会话一次）：smart-agent-memory → qmd → ACP，全部可选，失败即降级。
ACP 三级检测：sessions_spawn（30s 超时）→ acpx CLI（30s 超时）→ 直连执行，结果缓存至会话结束。
显著优点
1. 成本敏感设计：Simple 任务零 ACP 开销；Medium 用 run 模式避免 session 持久化成本；Complex 用磁盘上下文替代 IM-bound session，显著节省 token
2. 工具零依赖：所有工具（memory/qmd/ACP）均为可选，检测失败有明确降级路径，永不阻塞
3. 生产级安全边界：禁止在 ~/.openclaw/ 内执行、强制设置 cwd、最大并发 5 单元、单项目上下文文件 ≤10 个、智能超时与熔断
4. 双层标准隔离：项目级标准（CLAUDE.md/.cursorrules）由 Claude Code 自动读取，团队级标准（tech-standards.md）仅用于直连执行，避免提示词污染
5. 显式并行策略：允许并行但强制边界定义（按项目/模块/阶段/负责人），禁止同一代码链的并发修改，有 merge owner 和 acceptance owner 方可启动
潜在局限
- ACP 仅限 Claude：当前生产路径仅支持 Claude 作为 ACP coding agent，Codex 等未来 agent 仅作预留，实际无法路由
- 会话连续性依赖人工：Complex 任务的「会话延续」依赖现有 fullstack-dev 对话 + 磁盘上下文文件，非自动 session 恢复，需操作者主动维护
- 超时硬性：30s ACP 检测超时可能误判慢启动环境为不可用
- 并发硬上限：5 并发为全局上限，大型团队可能触及瓶颈
- PHP/Laravel 优先栈：技术栈偏好对中国以外市场通用性一般
适合人群
- 使用 OpenClaw/Claude Code 作为主力 IDE 的全栈开发者
- 需要处理「简单补丁→中型功能→复杂架构」全谱系任务的 individual contributor
- 重视 token 成本、工具链稳定性、有明确降级策略的生产环境团队
- 熟悉 Laravel/Vue/Flutter 技术栈的开发者
常规风险
| 风险场景 | 缓解机制 |
|---------|---------|
| ACP 不可用导致阻塞 | 三级检测 + 直连 fallback，永不阻塞 |
| 上下文文件膨胀 | 单项目 ≤10 活跃文件，任务完成即归档/删除 |
| 并发冲突 | 强制边界定义 + merge/acceptance owner，模糊边界则回退串行 |
| 敏感信息泄露 | 禁止硬编码密钥、DB 变更走 SQL 脚本、新技需确认 |
| 提示词注入 | 不将团队标准嵌入 ACP 提示，仅传任务描述 + 上下文路径 |
执行流程速览
1. 检测 → 确定 ACP_MODE（spawn/acpx/direct）
2. 分级 → Simple/Medium/Complex 匹配执行策略
3. 上下文 → 需要时写入 .openclaw/context-<task>.md
4. 执行 → 按模式 spawn/run/acpx/direct
5. 验证 → 测试 + 验收标准 + memory 记录
6. 清理 → 归档或删除上下文文件
最大重试 3 次，每次必须实质调整提示，之后强制降级或上报。