用途:solo-build 是 solo-factory 流水线(/plan → /build → /deploy → /review)中的执行引擎,用于把实现计划中的任务逐条落地。触发场景包括“build it”“start building”“execute plan”“implement tasks”“ship it”、引用 track ID,或计划任务需要执行时;不用于规划。
主要能力:在 docs/plan/ 下查找 plan.md,按顺序取第一个未完成任务([ ] 或恢复中的 [~]),标记为进行中,按 TDD 规则实现、提交并回写进度。支持通过参数指定 track ID 或 --task X.Y 直接跳转任务;无参数时列出含未完成任务的 track 供选择。每个任务完成后在 plan.md 中勾选并内联记录提交 SHA,阶段完成后做 SHA 审计、运行验证与测试、打 checkpoint 标记。全部完成后运行最终构建、测试、lint 与验收标准核对,更新 spec.md 勾选项,并在存在 .solo/states/ 时输出 solo:done/。
使用方式:先由 /plan 生成 spec.md 与 plan.md,再运行 /build。若存在 docs/workflow.md,会读取其中的 TDD 严格度、提交策略与验证规则;缺失时使用默认值(moderate TDD、conventional commits)。若可用,会调用 session_search、project_code_search、codegraph_query 等 MCP 工具,否则回退到 Glob、Grep、Read。项目根有 Makefile 时优先使用 make 目标。提交前需确认 git hooks 已安装(husky、pre-commit 或 lefthook),不得使用 --no-verify。
适用场景:已有实现计划的代码仓库,需要按任务循环推进开发、保持测试与提交可追溯。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;视觉验证(浏览器、模拟器、模拟器)为可选,工具不可用时跳过;同一构建或测试错误连续出现 3 次以上应停止重试并输出 solo:redo/;回滚使用 git revert,禁止 git reset --hard。