一个朦胧的想法到来了——大到一次 agent 会话装不下，又裹在迷雾中：从这里到目的地（destination）的路还看不见。寻路（wayfinding）是找出这条路，不是一头冲向目的地。本 skill 把路画成仓库 issue tracker 上的一张共享地图（map），然后逐一处理它的决策工单（decision ticket）——答案是决策、而非待执行构建切片的问题——一次一张，直到路径清晰。

目的地因任务而异，命名它是绘图的第一步——它决定后续每张工单的形状。它可能是一份要交接并迭代的规格、一个要在规划开始前锁定的决策、也可能是一处就地完成的改动（比如数据结构迁移）。地图与领域无关——工程、课程内容，只要符合上述形状就行。

规划，不是执行

Wayfinder 默认只规划：每张工单解决一个决策，地图在路径清晰时完成——别人去把事情做掉之前，已经没有要决定的东西了。想直接动手做的冲动，通常说明已到地图边缘，该交接了。某项任务可以在地图的 Notes 里另行声明，把执行也带进地图；没有这个声明，就只产出决策，不交付物。

按名称引用

每张地图、每张工单都是 issue，因此都有一个名字——它的标题。在人读到的所有地方（叙述、地图的 Decisions so far），用名字引用，不要用裸的编号、id 或 slug。一串 #42, #43, #44 没法读；名字一眼能懂。id 和 URL 不消失——名字裹住它的链接——但它们要骑在名字里面，不能取代名字。

地图

地图是本仓库 issue tracker 上的单个 issue，打上 wayfinder:map 标签——它是规范产物。它的工单是地图的子 issue。

地图是索引，不是仓库。它列出已经做出的决策，指向存放细节的工单；每个决策只在一处——它的工单里——完整记录，所以地图从不复述，只 gist 一行加链接。

地图本体、子工单、阻塞关系、前沿查询在物理上落在哪，取决于具体的 tracker。 issue tracker 约定应当已提供给你——如未提供，跑 /setup-ouyangjiahong-skills。具体仓库如何表达它们，见 tracker 文档的"Wayfinding operations"一节。若未配置 tracker，默认用 local-markdown tracker。