woostack-build 是 woostack 工作流中的构建控制器,围绕内部决策与规划阶段运行,负责在 .woostack/tmp/runs/<run-id>/ 下管理持久化本地运行,保留成功、Stop、Abandon 工件,并在验证后的交接点停止,由调用者选择一个完整的有界任务交给 Execute。
用途:为多增量功能准备规格与执行计划,产出可读的纯 Markdown 工件 project-spec.md 和 execution-plan.md,并支持可选的 Linear、Plane 或 GitHub 镜像同步。
主要能力:支持精确 --run 恢复指定运行;默认本地模式不调用任何 provider;通过 artifacts.provider 配置可选镜像;固定链路为分配或恢复运行、本地起草 Ideate/Harden、写入 project-spec.md、本地起草 Plan/Harden、写入 execution-plan.md、保留工件、展示验证交接并询问 Stop here/Execute/Abandon。
使用方式:命令为 /woostack-build <goal> [--project <URL-or-UUID>] [--run <exact-run-id>],或仅带 --run、仅带 --project。提供 --run 时只恢复该精确运行目录;省略时创建新运行。
限制:合并权限仅限人工,从不自动合并、入队或合并。自动 Execute 调度已退役,/woostack-execute --run <exact-run-id> 已退役,需由调用者提供有界输入。本地清单边界失败会阻塞在最后验证边界。Git 与 GitHub 读取仍是仓库交付权威,Git + gh 为默认。
适用场景:需要结构化规划、保留可读工件并人工控制执行交接的多增量功能开发。