wayfinder

技能简介

wayfinder 用于规划超出单个 agent 会话承载量的大型工作：把模糊的大目标拆解为 issue tracker 上的「决策地图」，逐张解决决策工单，直到通往目的地的路径清晰可见。

使用场景

• 想法太大太模糊，单次会话无法完成，需要先探明路径而非直接冲刺
• 动手前需要锁定规格说明、技术决策或数据迁移方案
• 多人/多 agent 协作时，用共享地图同步决策进展
• 跨领域工作（工程、课程内容等）都可用决策地图梳理

使用方法

1. 生成地图：wayfinder 会自动在当前仓库的 issue tracker 上创建标签为 wayfinder:map 的 issue 作为总地图，其子 issue 即决策工单。若未检测到 tracker，请让用户运行 /setup-matt-pocock-skills 完成配置。
2. 创建工单：每个工单是地图的子 issue，正文只写 ## Question（要解决的决策问题），并打上 wayfinder:<type> 标签（research、prototype、grilling、task）。
3. 认领工单：先把自己设为工单负责人（claim），再做任何工作，让并发会话跳过；用 tracker 原生的依赖关系标注阻塞，未阻塞且未认领的工单即「前沿」（frontier）。
4. 推进地图：逐个解决前沿工单；答案在关闭工单时记录，不写进正文；产生的资源以链接形式挂到工单下。直到无可决策项、路径清晰，即可交付。

注意事项

• 按名称引用：一律用工单标题称呼，不要用裸 ID（如 #42）；ID 和链接可包在名称内，但不能替代名称。
• 默认只规划、不执行：工单解决的是「决策」而非「交付物」，除非地图 Notes 中明确允许执行。
• HITL 工单必须真人参与：prototype、grilling、task 属于 HITL 类型；如 grilling 须同时调用 Skill 工具的 grilling 和 domain-modeling，agent 不得替人类作答。