用途:read-the-map 用于阅读一张 wayfinder 地图,回答“这张地图现在处于什么状态、下一步该做什么”。它同时定义了“读地图”的检查清单,其他需要读地图的技能(如 /whats-next、/check-wayfinder-maps)都遵循该清单,而不是各自另立标准。
主要能力:读取地图正文(Destination、Notes、Decisions so far、Specs settled、Not yet specified、Out of scope),读取子工单状态(open/closed、wayfinder:<type>、assignee、阻塞关系),读取构建待办(来自 /specs-to-tickets 的非 wayfinder 开放 issue 及是否已合并),识别前沿(开放、未被阻塞、未被认领的子工单),给出唯一裁决与一个下一步入口。
使用方式:先读仓库的 issue-tracker 文档 docs/agents/issue-tracker.md 的 Wayfinding operations 部分,了解该仓库如何表达地图、子工单与阻塞。文档未说明时的默认约定:地图是带 wayfinder:map 标签的 issue;子工单是地图的 GitHub sub-issue,带 wayfinder:<type> 标签;阻塞使用 GitHub 原生 issue 依赖,回退为正文中的 Blocked by: #n;已认领指工单有 assignee。裁决按顺序回答两个问题:决策是否完成、规格是否已切分为构建工单。裁决对应下一步入口,例如开放前沿工单则 take #<n>,规格未定则 /decisions-to-specs,未切分则 /specs-to-tickets,已切分则 /implement #<n>,需要制图则 /wayfinder on the fog,被阻塞或推迟则说明等待对象,完成则指向另一张地图。
限制:该技能从不写入,不做声明、评论、关闭或地图编辑;若阅读发现工作,应交给 /wayfinder、/decisions-to-specs 或 /specs-to-tickets。工单正文不在检查清单内,仅在 Notes 指向需修订且原因不明,或两个前沿工单标题无法判断优劣时才打开。地图自身的 Notes 优先于推断。输出应简短,用名称加链接引用地图与工单,不用裸 #42,单张地图不用表格。