核心用法
leio-sdlc 是一个基于多智能体协作的自动化软件开发框架,专为 OpenClaw 设计,将传统 SDLC 流程转化为可执行的 Bash 命令模板。系统包含四个核心角色:
- Planner:根据 PRD 文档生成 PR 合约(任务单)
- Coder:执行编码任务,内置
./preflight.sh自验证循环 - Reviewer:代码审查,输出
[LGTM]或[ACTION_REQUIRED] - Manager:状态机调度器,轮询任务队列并编排全生命周期
执行流程
1. 入口验证:Manager 必须确认 docs/PRDs/PRD_*.md 存在,禁止对话生成 PRD
2. 任务隔离:所有作业写入 .sdlc/jobs/<PRD_文件名>/,禁止全局目录污染
3. 队列轮询:get_next_pr.py 驱动 while 循环,直到 [QUEUE_EMPTY]
4. 强制自验证:Coder 必须本地运行 preflight 直至通过,禁止向 Manager 返回红灯
5. 修正循环:Reviewer 标记 [ACTION_REQUIRED] 时,触发 Coder Revision(最多 5 次)
6. 合并守卫:Reviewer 必须显式批准具体 commit hash,Manager 可用 --force-lgtm 覆盖死锁
显著优点
- 确定性执行:所有交互为 copy-pasteable 命令,消除 API 抽象泄漏
- 故障自愈:Coder 在沙箱内闭环修复,减少 Manager 上下文消耗
- 并发安全:Job 级目录隔离,支持并行多项目开发
- 审计追踪:PRD→PR→Review→Merge 全链路文件化,可复盘
潜在局限
- 强预设约束:必须预先编写 PRD,无法从模糊对话启动
- 工具链耦合:依赖特定 Python 脚本与 preflight.sh 约定
- Revision 上限:硬编码 5 次可能不足以解决复杂架构债务
- Manager 权限集中:
--force-lgtm绕过人审存在质量风险
适合人群
- 需要标准化 CI/CD 智能体流程的中大型开发团队
- 追求可解释、可审计的自动化代码生成场景
- 已具备 PRD 驱动文化、愿接受严格纪律约束的技术组织
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 无限循环 | Coder 反复无法通过 preflight | 设置超时与 Revision 硬上限 |
| 审查逃逸 | `--force-lgtm` 误用导致劣码入库 | 启用操作日志与事后审计 |
| 状态漂移 | Manager 与文件系统状态不一致 | 所有状态变更通过脚本原子化写入 |
| 并发冲突 | 多 Manager 同时操作同一 job 目录 | 文件锁或 UUID 目录隔离 |