wayfinder

用途

Wayfinder 解决的是“一个想法太大、单次智能体会话装不下，且通往目的地的路径尚不可见”的情形。它不直接奔向目的地，而是先找到路：在仓库的问题跟踪器上绘制一张共享地图，再逐个解决地图上的决策工单，直到路线清晰。

命名目的地：绘制地图的第一步是确定本次努力要到达的终点（一份规格、一个待锁定的决策，或一次就地改动如数据结构迁移）。目的地决定范围。
地图即索引：地图是跟踪器上带 wayfinder:map 标签的单个 issue，包含 Destination、Notes、Decisions so far、Not yet specified、Out of scope 五个部分；它只索引决策并链接到承载细节的工单，不重复决策内容。
工单类型：每张子工单标注 wayfinder:<type>，取值为 research（研究，AFK）、prototype（原型，HITL）、grilling（质询对话，HITL，默认）、task（前置任务，HITL 或 AFK）。
认领与阻塞：会话开始前先把工单指派给自己作为认领；用跟踪器原生依赖关系表达阻塞，未阻塞、未认领的开放子工单构成前沿（frontier）。
战争迷雾：地图刻意不完整，暂时无法精确表述的问题写入 Not yet specified；随前沿推进逐步“毕业”为新工单。超出目的地的工作进入 Out of scope，永不毕业。
按名称引用：地图与工单在其标题中命名，人类可读内容一律用名称而非裸 id、编号或 slug 引用。
单会话单工单：除 research 工单外，每次会话最多解决一张工单。

两种模式：

绘制地图（Chart the map）：用户以一个松散想法调用。先调用 /grilling 与 /domain-modeling 钉住目的地；再广度优先梳理前沿；创建地图与可明确表述的工单，第二轮再连阻塞边与交叉引用（需真实 id）；最后把相互独立、未阻塞的 research 工单批量提交给 /research，结果记录在临时 research/<name> 分支上，不合并。
推进地图（Work through the map）：用户以地图 URL 或编号调用，工单可选。加载地图低分辨率视图，选定并认领工单，按类型解决，将答案作为解决评论发布、关闭工单、在地图 Decisions so far 追加指针，并把新浮现的可表述问题毕业为新工单。

若未提供问题跟踪器，需提示用户运行 /setup-matt-pocock-skills；若仍无，默认使用 local-markdown 跟踪器。

工程工作、课程内容等任何符合该形状的领域；尤其适合需要先做一系列决策才能动手的大型模糊任务。