SuperAPI AI 工具集

describe-wayfinder-pipeline

测试与质量

查看项目

更新于 10-16 06:49

技能介绍

用途:这是一份流程参考技能,本身不执行任何阶段,用于判断一项变更该走长路线还是短路线,并指出下一步该由人打开哪扇门。

主要能力:给出两条路线的判定标准。四项全部满足时走 /quick-change:已决(几个直接问题即可定案)、小(一次会话可建、一个 PR 可读完)、在规格内(只改现有规格、不新增规格或 ADR、不冲突 ADR)、完成标准可命名。任一不满足则走长路线,常见信号包括:需求本身是“想办法搞清如何……”、需要新 ADR/新规格/新包、被其他程序集或仓库消费的契约变形、需要多张工单或多个会话协调。

阶段与命令:1 制图 /wayfinder <idea>,产出 wayfinder:map 议题;2 解决 /wayfinder <map>,每次会话处理一个决策;3 定案 /decisions-to-specs <map>,产出规格与 ADR 的 PR;4 切片 /specs-to-tickets <map>,在规格 PR 合并后生成 ready-for-agent 构建工单;5 构建 /implement <ticket>,另有 /implement-unattended、/implement-unattended-no-subagents、/subagent-implement、/tickets-to-lanes;6 落地 /create-pr-for-branch → /review-pr-in-worktree → /squash-merge-and-clean-up。

使用方式:无法自行打开仅限人工的门,需把命令交给人类执行。尚无地图用 /wayfinder <idea> 或 /wayfinder #<issue>;已有地图用 read-the-map 指出下一扇门,whats-next 生成可粘贴提示;多张地图用 /check-wayfinder-maps 巡检。

限制:几乎所有阶段仅限人工;每次会话只处理一个决策(研究工单除外);决策在阶段 3 前存于工单、之后存于规格;构建必须依据代码树而非决议评论,规格 PR 未合并前不生成构建工单;所有仓库写入都在独立 worktree 中、基于新拉取的 origin/main;审批按 approval-policy 记录在跟踪器;合并由人完成。资料未提供收费、价格、平台与效果信息。