用途
ub-workflow 是一个可移植的工作流层,用于那些规模过大、风险较高、跨领域或需要持久状态、仅靠聊天历史难以推进的工作。默认操作根目录为 ./.ub-workflows/,除非宿主有意选择其他根目录。
工作模型
该技能采用规范化的产品与敏捷混合模型:
Product Vision -> Product Options -> Outcome Waves -> Initiatives -> Discoveries -> Sprints
该模型结合了以下要素:
- 双轨敏捷:探索在交付拉取工作之前先验证选项;
- 目标导向的路线图:产品愿景保持宏观,波次和举措承载当前成果;
- 类似 Scrum 的冲刺执行:单一冲刺目标、检查与调整,以及 reviewed 模式下明确的启动审批;
- 看板式流控:显式策略、WIP 限制、承诺前选项、反馈回路和陈旧候选重新验证;
- Shape Up 影响:轻量下注框架、胃口(appetite)、熔断器和无积压泥潭;
- 胃口盒预测校准:候选数量是预测,扩展需在已界定选项和权衡之后由操作者选择。
目录结构
规范布局以 PROJECT_ROOT/ 为根,包含 AGENTS.md、SOURCE_ATLAS.md 和 .ub-workflows/。.ub-workflows/ 下包含 AGENTS.md、vision.md、options.md、status.md、WORKFLOW_ATLAS.md、SOURCE_PACK_ATLAS.md、source-packs/、waves/ 等;每个波次目录下含 wave.md、discoveries/、source-packs/、initiatives/;每个举措目录下含 initiative.md、options.md、roadmap.md、index.md、discoveries/、sprints/;每个冲刺目录下含 sprint.md、decision-log.md、closeout.md、evidence/(内含 .gitignore、index.md)。
命名规则:波次 ID 按项目顺序编号(w01、w02 等);举措 ID 按波次重置(i01、i02 等);波次级探索使用 wNN-dNN-slug.md 并按波次重置;举措级探索使用 wNN-iNN-dNN-slug.md 并按举措重置;冲刺使用 wNN-iNN-sNN-sprint-slug/ 并按举措重置;来源包使用 YYYY-MM-DD-slug/。
通道选择
选择能让已接受目标完成、验证并可恢复而不产生无关扩展的通道:
- 直接受限工作:小型单次会话变更,无需持久规划面;
- 波次/举措工作流:多会话、分阶段、高风险、产品塑造或跨领域工作,需要选项板、探索、路线图、冲刺、收尾和可恢复证据。
当当前通道不再提供足够持久面以完成并证明已接受目标时,提升通道,并在拥有该工作的产物中记录提升原因。
核心契约要点
可复用工作流规则保留在技能中,而非单一仓库覆盖层;仓库覆盖层保持精简。vision.md 拥有产品北极星;根 options.md 拥有精选的产品级、未来波次和未知归属选项;status.md 拥有当前产品姿态、波次排序、活动指针、阻塞、WIP 状态、候选轨道、保留上下文路线和下一允许动作。
探索是正常的上游引导工作,而非特殊仪式。冲刺是从已接受的探索或经审阅的冲刺预览中拉取的交付切片。默认 WIP 为受限双轨:每个活跃举措一个活跃交付冲刺和一个活跃探索;波次探索仅在激活、过渡或改道时活跃。
交互模式
reviewed(默认):执行前预览、之后明确启动审批、执行后报告、收尾后暂停;flow:简短执行前说明、执行后报告、手动推进;auto:内部执行前分析并自动推进,除非阻塞、冲突或路径塑造决策需要中断;continuous/yolo:无例行暂停,但所有门禁、产物和中断规则仍然适用。
模式改变可见性和暂停行为,不削弱就绪、证据或回写要求。
目标完成规则
选择目标完整动作:实现并验证已接受冲刺目标与退出标准所需的所有工作。避免无关扩展,但不得为保留范围或预算而削减、推迟或拆分所需证明。当使用“最小”“最窄”或“按需”等词时,应理解为最小目标完整垂直切片,而非让第一个聚焦测试通过的最小补丁。
按触发加载参考
技能附带按阶段和边界条件触发的参考文档:references/workflow-contract.md(生命周期细节、WIP 策略、reviewed 模式预览与恢复)、references/artifact-contracts.md(创建或校验工作流产物)、references/context-management.md(上下文层级、预算、图谱路由等)、references/trace-tokens.md(追踪令牌与工作流搜索)、references/validation-and-completion.md(就绪、收尾、归档、完成)、references/scaffold-helper.md(确定性辅助脚本)、references/placeholder-contract.md(严格占位符校验)、references/governance-bridge.md(治理映射激活时),以及 ../ub-authoring/references/authoring-conventions.md(共享路由、命名或选择问题编写变更时)。
内置资产与脚本
使用 assets/operations-root/ 和 assets/initiative-template/ 作为规范模板。使用 scripts/scaffold_workflow.py 进行确定性引导、波次、举措、探索、来源包、冲刺和归档操作。使用 scripts/check_workflow_options.py 进行选项板过渡、收尾、终审和陈旧卡片校验。
输出要求
对于非平凡工作流工作,应报告:通道与规模决策、活动产物所有者、WIP 与门禁状态、路径选择时选定的路径与被拒替代方案、验证与证据预期、下一允许动作。
限制
该技能主要面向前述大型、状态化、跨领域工作的流程管理,不适用于无需持久规划面的小型单次变更;具体运行时行为、宿主集成方式及兼容性策略需由宿主环境确定,资料未提供更多平台与实现细节。