Wayfinder 是 leek/agent-skills 中的一个技能，用来处理“一次智能体会话装不下、且前路尚不清晰”的任务。它的核心立场是：先寻路，再冲刺；先做决策，不做交付。
用途与定位 当用户带来一个松散想法，从当前位置到目的地的路线还不可见时，Wayfinder 不直接动手实现，而是先把路线绘制成一张共享地图。地图是 .scratch/ 下的 Markdown 文件，其子项是一张张决策工单。每个工单解决一个问题——该问题的答案是一个决策，而不是要构建的产物。逐个会话解决工单，直到路线清晰。
在流程中的位置 Wayfinder 属于“决策”阶段，完整流水线为：wayfinder（决策）→ to-spec（写规格）→ to-tickets（拆工单）→ implement（每会话构建一张工单）。一张地图产出一份规格：决策清晰后运行一次 to-spec，地图即告完成。若工作规模超过单份规格，说明目的地画得太宽，应收窄范围，其余部分日后另绘地图。
主要机制
- 先命名目的地：绘制地图的第一步是确定目的地，它决定整个范围，并塑造每一张工单。目的地可能是一份交给 to-spec 的规格、规划前需锁定的决策，或某次就地变更背后的决策。
- 工单类型：研究（research）、原型（prototype）、质询（grilling）、任务（task）。其中任务工单是地图上唯一被允许的“做事”，指为解锁某个决策而做的手工工作，解决后不留下构建状态。
- 判断标准：每张工单都要问“它是能被回答，还是必须被构建？”需要构建的工作不属于工单，属于规格。
- 地图即索引：地图本身不存储决策细节，只列出已做决策并指向持有细节的工单；一个决策只存在于一个地方。
- 按名称引用：地图和工单都以标题命名，给人阅读时用名称加链接，避免堆砌裸路径。
- 迷雾与范围外：尚无法明确的内容留在“尚未指定”区域；答案显示超出目的地的工单用关闭操作排除在范围外，而非解决。
使用方式 两种模式，且无论哪种都不会在一次会话中解决超过一张工单（研究工单和整图运行除外）：
- 绘制地图：用户以松散想法调用。先通过质询（结合领域建模）确定目的地；再广度优先地梳理前沿，列出未决决策与当前可迈出的第一步。若没有未解决的决策工单，则无需地图，直接询问用户前往 to-spec 还是 to-tickets。之后通过跟踪器的创建地图、创建工单操作建图建单，并接线阻塞关系，再把能指定的内容之外的部分留在迷雾中。最后解决符合条件的研究工单。
- 推进地图：用户以地图（路径或标题）调用，可选指定工单，否则取第一张前沿工单，先认领再解决，按跟踪器记录答案并关闭工单，然后新增浮现的工单、把迷雾中已可明确的部分毕业出来。带 all 参数时为整图运行，循环处理整个前沿。
依赖与限制 地图、工单、规格均为 .scratch/ 下的 Markdown 文件，布局每会话从 .agents/issue-tracker.md 读取（由 /setup 写入）；若缺失则尝试 docs/agents/issue-tracker.md（旧版）及 setup 技能的种子，并建议运行一次 /setup 使路径持久。结构化提问遵循质询技能的问题形态：推荐项在前、列出真实取舍、等待回答。由于用户可能并行运行已解锁工单，需预期其他会话并发编辑跟踪器。会话结束时按 references/pipeline-end-block.md 的框架打印结束块，写之前先查询当前前沿而非猜测。具体的地图与工单模板、认领/阻塞/解决机制、工单类型、迷雾与范围规则、整图运行流程等，分别见 references/map-and-tickets.md、references/ticket-types.md、references/fog-and-scope.md、references/map-run.md 等参考文件。