用途:wayfinder-pipeline 是一份流程参考,描述从松散想法到合并代码的长路线,以及用于选择长路线或 /quick-change 的判定测试。它本身不运行任何阶段,几乎所有阶段都是人工专属,需要由人打开对应的门。
路线选择:当四个条件同时满足时走短路线 /quick-change——已决定(几个直接问题即可关闭疑问)、规模小(一次会话可完成、一个 PR 可读完)、在既有规格内(只需编辑而非新建 spec 或 ADR,且不违背任何 ADR)、完成标准可命名(现在就能写出验收标准)。任一不满足则走长路线,常见信号包括:存在迷雾(请求是“想办法……”或追问会展开决策树)、需要新 ADR/新 spec/新包或程序集、其他程序集或仓库消费的契约改变形态、工作量相当于多个工单或需其他会话协调。判断应针对变更本身而非句子,先读代码和它落地的 spec。测试只给建议,由人决定;人也可把长变更送上短路线,该决定按 approval-policy 记录在 issue 上。
阶段:各阶段输出即下一阶段输入,跳过会导致下一步无内容可读。1. Chart:/wayfinder <idea>,从松散想法生成 wayfinder:map issue,含 Destination、Not yet specified 下的迷雾、由阻塞边连接的子决策工单。2. Resolve:/wayfinder <map>,每次会话处理一个决策,产出 resolution 评论、关闭工单并记入 Decisions so far,直到路径清晰。3. Settle:/decisions-to-specs <map>,把已解决决策写成 spec 文件和 ADR,在 worktree 中开 PR,决策工单标记 superseded。4. Slice:/specs-to-tickets <map>,在 spec PR 合并后,逐个 spec 生成 ready-for-agent 构建工单并作为子 issue 链接。5. Build:/implement <ticket> 或无人值守模式,在独立 worktree 分支上提交代码、测试与 spec 修改。6. Land:/create-pr-for-branch → /review-pr-in-worktree → /squash-merge-and-clean-up,合并后构建工单才关闭。
构建入口:/implement 处理单工单、人可联系、停在提交;/implement-unattended 在人离开时授予命名与决策权,跨子代理分发工单并返回一个 PR;/implement-unattended-no-subagents 为串行版本;/subagent-implement 并行处理多个独立工单,各出一个 PR;/tickets-to-lanes 在一张地图上运行多个无人值守会话。借用的决策事后通过 /settle-borrowed-authority 处理,评审答复通过 /respond-to-pr-review。
各阶段通用规则:地图上每次会话一个决策(研究工单除外);决策在阶段 3 前存于工单,之后存于 spec,构建从树而非 resolution 评论出发;每次仓库写入都在独立 worktree 中,基于新拉取的 origin/main,除非人工另选基线;审批按 approval-policy 记录在跟踪器;合并由人完成。
引导人工:无法自行打开人工专属的门,需给出要输入的命令——尚无地图时用 /wayfinder <the idea> 或 /wayfinder #<issue>;已有地图时对其调用 read-the-map 获知下一道门,whats-next 可生成可粘贴提示;多张地图时用 /check-wayfinder-maps 总览。应说明是哪个信号把工作引到这里,便于人工推翻。
限制:该技能仅为参考,不执行阶段;多数阶段需人工开启;具体收费、平台与效果资料未提供。