wayfinder

一个松散的想法到来了：它大到单个 agent 会话装不下，还笼罩在迷雾中，从这里通往目的地（destination）的路还看不见。探路（wayfinding）要找的是这条路，而不是直冲目的地。本 skill 把这条路绘制成仓库工单系统（issue tracker）上的一张共享地图（shared map），然后逐一推进其中的决策工单（decision ticket）（这些问题各自的解答本身就是一个决策，而不是待执行的构建切片），直到路线清晰为止。

目的地因每项工作而异，为它命名是绘图的第一步：它塑造之后的每一张工单。它可以是一份用于交接和迭代的 spec（规格说明）、一个在规划开始前就要锁定的决策，也可以是一次就地完成的变更，比如数据结构迁移。这张地图与领域无关：工程工作、课程内容，任何符合这个形状的东西都可以。

规划，而非执行

Wayfinder 默认做的是规划：每张工单解决一个决策；当路径已清晰、在有人去实际动手之前再无待决事项时，地图就算完成。那种想直接把活干了的冲动，通常正说明你已到达地图的边缘，该交接了。一项工作可以在其 Notes 中覆盖这一默认，把执行也纳入地图本身；但若没有这类说明，就产出决策，而不是交付物。

用名称引用

每张地图和每张工单都是一个 issue，因此都有一个名字：它的标题。在人类阅读的一切内容里（叙述文字、地图的 Decisions so far），都用这个名字称呼它，绝不用裸的 id、编号或 slug。满屏的 #42, #43, #44 无法辨读；名字一眼即懂。id 和 URL 并不会消失：名字包裹着它的链接，它们_藏在_名字里面，绝不能取而代之。

地图

地图是本仓库工单系统上的单个 issue，带 wayfinder:map 标签，是权威工件。它的工单是地图的子 issue。

地图是索引，不是存储。它列出已做出的决策，并指向承载细节的工单；一个决策只存在于一个地方——它的工单——所以地图从不复述决策，只给出摘要和链接。

地图、其子工单、阻塞关系以及前沿（frontier）查询实际存放在哪里，因工单系统而异。 工单系统本应已经提供给你。如果没有，请让用户运行 /setup-engineering-skills。请查阅工单系统文档中的“寻路操作”一节，了解_本_仓库如何表达这些内容。如果确实没有提供任何工单系统，默认使用本地 Markdown 工单系统。

地图正文

整张地图的低分辨率视图，每个会话加载一次。open 状态的工单不列出：它们是 open 的子 issue，靠查询获取。

## Destination

<what reaching the end of this map looks like: the spec, decision, or change this effort is finding its way to. One or two lines; every session orients to it before choosing a ticket.>

## Notes

<domain; skills every session should consult; standing preferences for this effort>

## Decisions so far

<!-- the index: one line per closed ticket, enough to judge relevance, then zoom the link for the detail the ticket holds -->

- [<closed ticket title>](link): <one-line gist of the answer>

## Not yet specified

<!-- see "Fog of war": in-scope fog you can't ticket yet; graduates as the frontier advances -->

## Out of scope

<!-- see "Out of scope": work ruled beyond the destination; closed, never graduates -->

工单

每张工单都是地图的子 issue；工单系统的 issue id 就是它的身份标识。工单正文就是问题本身，规模以一个 100K token 的 agent 会话为限：

## Question

<the decision or investigation this ticket resolves>