wayfinder

用户带来一个还很松散的想法：规模大到一个 agent 会话无法完成，而且从现状到目标的路径还不清楚。本 skill 负责找出这条路径，而不是直接朝目标动手。

做法是在仓库的 issue 追踪器上建立一张共享地图，然后逐个处理其中的决策项，直到路径明确。决策项是需要解决的问题，解决后得到一个决定，而不是一块要实现的功能。

目标因工作而异，确定目标是建图的第一步，它会影响每一个决策项。目标可能是一份需要继续迭代的规格、开始规划前必须确定的决定，或者一次可以直接完成的改动（例如数据结构迁移）。地图不限于工程领域，课程内容等工作只要形态合适也可以使用。

目标是交付一个产品、子系统或一组面向用户的功能时，地图还要维护一份功能清单，列出要交付的全部功能项，以及每项的发布批次、交互要求和设计依据。格式、位置和修改规则见 docs/agents/feature-list.md；没有这个文件时，告诉用户运行 /setup-dev-skills。

决策项只保证每个决定都已作出，不保证功能项已梳理完全。所以功能清单也是地图完成条件的一部分，见“路径明确之后”。

只规划，不实现

默认情况下，本 skill 只做规划：每个决策项解决一个决定；路径明确、实现前已没有需要决定的事项时，地图就完成了。

想直接动手实现，通常说明规划已经完成，应该进行交接。某项工作可以在地图的备注中改变这条规则，把实现也纳入地图；没有这样写时，只产出决定，不产出交付物。

用标题指代 issue

每张地图和每个决策项都是一个 issue，都有标题。在给人阅读的内容中（叙述、地图的“已做决策”），用标题指代 issue，而不是只写 id、编号或 slug。满屏的 #42, #43, #44 难以阅读，标题一眼就能看懂。