关于 read-the-map
Read The Map 是用于检查问题跟踪器中单个项目地图的 Agent 技能。它按固定清单判断地图状态、可推进事项和下一步，且只读、不修改跟踪器数据。
主要功能
- 01读取地图详情和子任务状态
- 02检查待办及任务依赖关系
- 03找出开放、未阻塞且无人认领的工作
- 04按规则给出判定和下一步
- 05仅报告结果，不进行编辑
适用场景
- 01判断项目地图是否可进入实施
- 02寻找地图上可着手的任务
- 03检查规格是否已拆分为任务
- 04报告阻塞项或延期事项
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/read-the-map确认已加载。
详细介绍
阅读地图
这张地图目前处于什么状态，接下来该做什么？此技能会回答某张地图的这些问题，并负责维护检查清单，明确阅读地图意味着什么——其他所有需要阅读地图的事项，包括 /whats-next 和 /check-wayfinder-maps，都应遵循此清单，而不是另行编造。
**此技能绝不写入内容。**不添加声明、不发表评论、不关闭事项、不编辑地图。它只负责阅读和汇报。如果阅读后发现有工作要做，请交给 /wayfinder、/decisions-to-specs 或 /specs-to-tickets。
跟踪器约定
阅读仓库的问题跟踪器文档（docs/agents/issue-tracker.md），具体查看其中的 寻路操作 部分，了解此仓库如何表示地图、子任务和阻塞关系。这是针对每个仓库的查阅，而非针对每张地图的查阅。文档未说明时，采用以下默认值：
- 地图 — 标记为
wayfinder:map的问题 - 子任务 — 地图的 GitHub 子问题，标记为
wayfinder:<type> - 阻塞关系 — GitHub 原生问题依赖关系；若不可用，则在正文中使用
Blocked by: #n行 - 已认领 — 该任务已分配给某人
检查清单
以下所有操作都针对当前地图。第 2 和第 3 项来自列表级数据——标题、状态、标签、受派人和依赖关系，这些信息无需打开任何内容即可由跟踪器返回；第 1 项是唯一必须阅读的正文。
- 完整阅读地图正文。
Destination、Notes（延期标记、执行覆盖项、本次工作会参考的技能）、Decisions so far、Specs settled、Not yet specified、Out of scope。就绪信号在这里，而不在任务数量中——即使没有未完成的子任务，地图也可能仍是一片未开始梳理的迷雾。 - 地图子任务的状态——开放或已关闭、
wayfinder:<type>、受派人，以及阻塞关系。 - 构建待办事项——来自
/specs-to-tickets的未完成非 wayfinder 问题，以及其中是否有任何问题已合并。就绪情况取决于规格是否已经拆分。 - 前沿任务——开放、未受阻且未认领的子任务。只有这些任务能由下一次会话实际接手。
- 结论——从表格中严格选择一项。
- 下一步——从映射表中选择一个入口。
地图自身的 Notes 优先于你的推断。地图上写着“已准备好创建任务”，这是作者的判断；应将其作为作者的判断如实报告，只有在迷雾明显表明情况并非如此时才予以反驳。
结论
依次回答两个问题：**决策是否已完成？**然后，规格是否已拆分为构建任务？
| 结论 | 适用情况 |
|---|---|
| 是 — 已拆分 | 没有未完成的决策，规格已确定，且已创建实现任务 |
| 是 — 尚未拆分 | 没有未完成的决策，规格已确定，但尚未创建构建任务 |
| 是，但有保留事项 | 已拆分，但任务附有修订说明，或后续决策使其失效 |
| 否 — 需要梳理 | 地图只是占位内容，或存在尚无任务覆盖的迷雾 |
| 否 — 被 #n 阻塞 | 正在等待另一张地图的输出 |
| 否 — 有意延期 | 地图的 Notes 将其标记为等待未来事件；暂且搁置 |
| 已完成 | 所有内容都已关闭、拆分并合并 |
结论 → 下一步
| 结论 | 入口 |
|---|---|
| 有开放的前沿任务可接手 | take #<n> — <title> — 选择能解除最多阻塞的任务，或最快能完成的任务 |
| 没有未完成的决策，规格尚未确定 | /decisions-to-specs |
| 是 — 尚未拆分 | /specs-to-tickets |
| 是 — 已拆分 | /implement #<n> — <title> |
| 已拆分，但某个任务的方案仍只是猜测 | /prototype #<n> — <title> — 在有人提出要求时，或尝试原型比争论后将其定为稳定方案更合适时 |
| 否 — 需要梳理 | 针对迷雾使用 /wayfinder |
| 被阻塞或已延期 | 此处没有下一步；说明它正在等待什么 |
| 已完成 | 这张地图已完成——下一步是处理另一张地图 |
缩放范围
工单的正文不在检查清单范围内。仅在以下情况打开正文：
- 地图的
Notes指出需要修订，但你看不出原因；或 - 有两个前沿工单处于进行中，且仅凭标题无法确定哪个更适合作为下一步。
检查清单所需的其他内容都在列表层级。
输出
简短。给出判断、用一行说明下一步、按名称列出前沿，以及地图上任何与之矛盾的内容。提及每张地图和工单时都要按名称链接，绝不能只写 #42。只有一张地图时不要用表格；用文字更简洁。
在流程中的位置
这是其他技能所依赖的读取步骤。/whats-next 会将此技能的下一步转化为提示词。/check-wayfinder-maps 会同时对每张打开的地图运行检查清单——必须涵盖每一项，但可以通过批量追踪器查询来满足要求，而不必逐张地图检查；有十张地图时这种方式效率更高，只有一张时则毫无必要。