wayfinderlisted
Install: claude install-skill 988hj7tczd-oss/skill-tool
# Wayfinder — 大规模计划导航
一个模糊的想法来了——太大,一个 Agent session 装不下,而且被迷雾包裹着:从这里到**目的地的路还看不见**。Wayfinding 是关于找到路,不是冲向目的地。这项技能把路线���制成 issue tracker 上的**共享地图**(shared map),然后逐个处理**决策 ticket**( decision tickets)——每个 ticket 是一个问题,其答案是决策,不是可执行实现的切片——直到路线清晰。
## 计划,不做
Wayfinder 默认是**计划**:每个 ticket 解决一个决策,地图完成时就是路线清晰时——没什么需要决定的,可以动手了。
## 地图
地图是 issue tracker 上的一个 issue,标注 `wayfinder:map`。其 tickets 是该地图的子 issues。
地图是**索引**,不是仓库。它列出已做的决策并指向持有详情的 tickets;一个决策只在一个地方——它的 ticket。
### 地图主体
```markdown
## 目的地
<到达地图终点时什么样子>
## 笔记
<领域;每个 session 查阅的技能;该努力的固定偏好>
## 已做决策
- [决策标题](link) — 答案概要
## 尚未确定的
<!-- 迷雾区域:你能感觉到但还无法精确描述的问题 -->
## 超出范围
<!-- 故意排除的工作 -->
```
### Tickets
每个 ticket 是地图的���个子 issue。body 是问题,大小适合一个 100K token 的 Agent session:
```markdown
## 问题
<这个 ticket 要解决的决策或调查>
```
带 `wayfinder:<type>` 标签,其中 type 为:`research` | `prototype` | `grilling` | `task`。
## 迷雾
地图*故意*不完整:不要绘制你还看不到的东西。在活跃 ticket 之外是**迷雾**——你能感觉到但还无法精确描述的问题。
**迷雾还是 ticket?** 标准是:你现在能否精确陈述问题——不是能否现在回答它。
## 运行
### 绘制地图
1. 命名目的地 → grilling + domain-modeling
2. 广度优先绘制���雾 → 再次 grilling
3. 创建地图 issue
4. 创建可立即指定的 tickets
5. 启动 research sub-agents 并行解析 research tickets
### 执行地图
1. 加载地图
2. 选一个 frontier ticket(无人认领、无阻塞、开放的)
3. 解决它(grilling + domain-modeling)
4. 记录决议 → 关闭 ticket → 更新地图
5. 添加新浮现的 tickets