📊 页面导航

    适用角色与上手难度

    角色推荐度上手难度
    🛠️ 开发★★★★★★★★★☆
    🧪 测试★★★☆☆★★★★☆
    📦 产品★★★★☆★★★★☆

    🎯 学习产出： 掌握大项目的决策地图规划法，能把模糊愿景拆成可逐个解决的决策票据

    🚀 AI 能力提升： 大规模规划、决策分解

    /wayfinder

    预计阅读时间: 8 分钟

    大项目规划。一个松散的、太大装不进单个 agent 会话的想法来了，裹在迷雾里：从这里到目的地的路还看不见。本技能把路画成 issue 追踪器上的一张共享地图，然后逐个解决它的决策票据（其解决是决策、而非待执行的构建切片的问题），直到路线清晰。

    这是整个集合里认知负担最重的流程。/grill-with-docs 磨尖的是单会话能握住的想法；wayfinder 处理握不住的——它更慢更密，只留给真正巨大的工作，永远不要用在范围清晰的 feature 上。

    日常使用

    两种模式。每个会话最多解决一张票据（research 票据除外）：

    /wayfinder 我们要从零做一个数据平台      # 模式一：绘制地图
/wayfinder <map 的 URL 或编号>           # 模式二：继续解地图

    实战

    规划，而不是动手

    默认只做规划：每张票据解决一个决策，地图在路线清晰、动手前无决策可做时完成。"忍不住想直接干活"通常是到达地图边缘、该交接的信号。产出决策，不是交付物。

    地图

    地图是追踪器上的一张 issue，标签 wayfinder:map，是规范产物。它是索引，不是仓库：列出已做决策、指向持有细节的票据——一个决策只存在一个地方（它的票据）。

    地图正文（低分辨率，每会话只加载一次）：

    ## Destination

<到达终点是什么样：规格、决策或改动。一两行；每个会话都先对它定向再选票据。>

## Notes

<领域；每会话应查阅的技能；本工作的长期偏好>

## Decisions so far

<!-- 每张已关闭票据一行，足够判断相关性，再放大链接看细节 -->

- [<票据标题>](link): <答案的一行摘要>

## Not yet specified

<!-- 战争迷雾：范围内但还无法开票的，随前沿推进毕业 -->

## Out of scope

<!-- 被排除的工作：关闭，永不毕业 -->

    票据

    每张票据是地图的子 issue，正文是问题，尺寸匹配一次 100K token 的 agent 会话：

    ## Question

<这张票据解决的决策或调查>

    带 wayfinder:<type> 标签。会话认领票据 = 先把它分配给自己，再做任何工作，并发会话会跳过它。阻塞用追踪器原生依赖关系（让前沿在追踪器 UI 里可视化）。票据解除阻塞 = 所有阻塞它的票据都关闭；前沿 = 打开、无阻塞、未认领的子票据。

    票据类型

    类型HITL/AFK什么时候用解决方式
    ResearchAFK需要仓库外的知识（文档、API、知识库）子 agent 调 "research"
    PrototypeHITL"长什么样/怎么表现"是关键——做粗糙原型来讨论子 agent 调 "prototype"，原型作为资产链接
    GrillingHITL默认情况——对话调 "grilling" + "domain-modeling"
    Task两者皆可决策前必须做的杂活（注册服务、开通权限、搬数据）agent 独立做或给人精确清单

    HITL 票据只能通过和"能替自己说话的人"的现场交流解决——agent 绝不代替人的那一侧（自己答自己问题的 grilling agent 已破坏此规则）。

    战争迷雾

    地图刻意不完整：别画你看不见的。超出活跃票据的是迷雾——能看出要来但还钉不住的决策。开票还是迷雾？ 测试是：现在能否精确表述这个问题（不是能否回答）。能 → 开票；不能 → 写进 Not yet specified。别把迷雾预先切成票据大小的块——一块迷雾可能毕业成多张票据或零张。

    范围之外永不毕业（前沿止于目的地），只有目的地重画才回归，且作为全新工作而非恢复。已有的票据发现超出目的地就关闭它，在 Out of scope 留一行（摘要 + 为什么 + 链接）。

    绘制地图（模式一）

    1. 命名目的地——先调 "grilling" + "domain-modeling" 钉住这张地图要通向哪里。目的地固定范围，先定它
    2. 广度优先画前沿——不深入任何一条线，扇出整个空间，浮出开放决策和现在就能走的第一步。如果浮不出迷雾（路线已清晰、全程单会话装得下），你不需要地图：停下问用户怎么办
    3. 创建地图（wayfinder:map）：填 Destination 和 Notes，Decisions-so-far 留空，迷雾写进 Not yet specified
    4. 创建现在能明确的所有票据（地图的子 issue），第二遍连阻塞边（issue 需要先有 id 才能互相引用）
    5. 派出 research 子 agent——为刚创建的 research 票据并行解决，发现放在一次性 research/<name> 分支，票据上留上下文指针
    6. 停：绘制是单会话的工作，它不手工解决任何东西

    解地图（模式二）

    1. 加载地图（低分辨率视图，不读每张票据正文）
    2. 选票据：用户点名就用它，否则按顺序取第一张前沿票据。先认领（分配给自己）再做任何工作
    3. 解决它：按需放大拉取相关/已关闭票据全文；## Notes 点名哪个技能就调哪个，拿不准就调 "grilling" + "domain-modeling"
    4. 记录解决：答案贴解决评论、关闭 issue、把上下文指针追加到地图的 Decisions-so-far
    5. 添加新浮出的票据（先创建再连线）；毕业迷雾（可规格化就开票，从 Not yet specified 清掉）；票据落在目的地之外就判出范围而不是解决它；决策使其它票据失效就更新或删除

    用户可能并行跑未阻塞的票据，所以预期其它会话在并发编辑追踪器。

    与其它技能的关系

    • 汇入：地图清晰后交接而不构建——从 /to-spec 汇入主流程（把地图的链接决策塌缩成可构建计划），再走 /to-tickets → /implement。只有工作确实很小才直接 /implement
    • 内部调用：grilling、domain-modeling、prototype、research