# Wayfinder

> 当你迷路、前路不明、或必须决定接下来做什么时用它。画一张通往目的地的决策地图，而不是把问题扔给人搁着。Trigger words: wayfinder, the path, chart the route, map the work, what next, lost, fog of war, decision map, frontier. 中文触发词：探路、画路线、迷路了、接下来做什么、决策地图、战争迷雾、工作地图、前沿。

- Skill: `tcuzzo/wayfinder-7` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tcuzzo/wayfinder-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tcuzzo/wayfinder-7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: Tcuzzo (https://skillmd.com/u/tcuzzo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tcuzzo/wayfinder-7

---


# Wayfinder
**Effort:** free — 纯探路纪律：用磁盘上已有的证据搭一张决策地图，零额外模型调用。消除：证据本可回答、却被搁到人头上的问题，以及在前置决定尚未做出时就开工的构建。

不认路的时候，最省事的动作是停下来，把人雇你来回答的问题反问回去。探路者选另一条路：搭一张决策地图，用证据消解未知，只把真正属于人的抉择送上去。

## 什么时候跑

- 你迷路了，或者下一步不清楚。
- 一项大工程在任何人动工之前需要拆解。
- 你感到那股想问"你想让我做什么？"的引力。

## 步骤

1. **点名目的地。** 跟踪器里一个具名的目标，加一条收口判据：你怎么知道它做完了。目的地钉死范围。
2. **把看得见的画出来。** 在前沿建工单——现在就能着手消解的决定。每张工单消解的是一个**决定**，不是一块构建工作。
3. **其余留在迷雾里。** 感觉得到但还钉不住的决定，放进**尚未明确**（Not yet specified）小节：疑似的问题、要回头看的区域。不许把迷雾预切成工单大小——它比工单粗，一片迷雾之后可能孵出几张工单，也可能一张都没有。
4. **把出局的说出声。** 目的地之外的工作不是迷雾——它进**范围之外**（Out of scope）小节，永不孵化。一张进行中的工单后来发现落在目的地之外，就关掉它，在范围之外留一行。
5. **给每张工单定类型**（见下面的工单类型）。
6. **用证据消解一个决定。** 读代码、读文档、读记录——确定性的证据不靠猜就能关掉一张工单。关掉一张工单会拨开它前方的迷雾：把此刻能明确的孵化成新工单，一次一张。
7. **路清了就交棒。** 当"去把事做了"之前已无任何待决之事，地图就完成了。那股"干脆自己上手"的引力，正是你抵达地图边缘的信号。

## 迷雾还是工单？

检验标准是你现在能否**精确地**说出那个问题——不是你现在能否回答它。问题锋利了就开工单，哪怕暂时被卡。还说不了那么锋利，就归尚未明确。

## 工单类型

每张工单要么是**人在环**（和人实时一起做），要么是**agent 独立**。人在环的工单只能通过实时交流消解——agent 绝不代演人的那一边。agent 自己回答自己的追问，就已经违反了这一条。

- **调研**（agent 独立）— 一个后台调研 agent 去消解；发现落在 scratch 分支上，工单里留指针。见 [live-research](../live-research/SKILL.md)。
- **原型**（人在环）— 用一个便宜的粗糙产物拉高保真度，让人能对着它反应。
- **追问**（人在环）— 把决定聊出来的对话。默认类型。
- **事务**（皆可）— 决定之前必须发生的手工活：注册服务、开通权限、搬数据。唯一"做事"而非"决策"的类型；它靠解锁一个决定挣得席位。

## 硬性规则

- **凡是证据、代码或既有规则能回答的问题，绝不扔给人搁着。** 只有品味、愿景和破坏性风险的抉择才上去——见 [decision-bar](../decision-bar/SKILL.md)。
- **用名字指代工作，绝不用裸编号。** 一墙的 #42、#43、#44 没法读；名字一眼即懂。编号或链接附在名字里——绝不代替名字。
- **一次会话一个决定。** 每次会话至多消解一张工单，调研工单除外。画图本身就是一场会话的工作量；画图不顺手消解任何东西。
- **规划，不动手。** 地图产出的是决定，不是交付物。
- **当请求本身就是迷雾**——目的地不明，因为需求是以散文或比喻到达的——先用 [intent-compiler](../intent-compiler/SKILL.md) 读懂请求，再从它真正说的内容开始画。

## 搭配使用

- [live-research](../live-research/SKILL.md) — 消解 agent 独立的调研工单。
- [decision-bar](../decision-bar/SKILL.md) — 哪些决定才真正递到人面前。
- [human-voice](../human-voice/SKILL.md) — 地图在人眼里读起来什么样。

> 脚手架致谢：Matt Pocock, wayfinder (mattpocock/skills, MIT)。此处的组合方式与硬性规则属于 BACKS AIOS。