Imported from whinc/super-skills (
plugins/engineering/skills/wayfinder-team/SKILL.md). Install upstream withnpx skills add whinc/super-skills --skill wayfinder-team. Copyright stays with the author.
Wayfinder team
职责与边界
本 skill 只处理一个 map.md 与其同目录 issues/ 下的 child issues。map.md 只读：对地图的补充以新增 issue 文件形式进行，不得直接改写 map。不得读取或接收 PRD/spec 实现 tickets，也不处理 direct-task。每个 child issue 是唯一执行单元；map 本身不是 ticket。团队使用原生 TeamCreate 创建一个 AgentTeam，主 Agent 是唯一 coordinator、派发者、依赖解锁者和独立核验者；成员共享 team 上下文但不能自行解锁后继。
公共 manifest、终态事件、DAG、失败传播、context 卫生、核验和 fail-closed 规则见 docs/agents/agent-team-protocol.md 与 references/manifest-template.md。
输入评估与确认门禁
- 只读取指定
map.md、同目录issues/的 child issue；保留 issue 原文、Type:、Status:、Blocked by:、tracker 路径、问题范围、evidence 和地图 Decisions-so-far 指针。不得把 map 当成单一任务。 - 检查 issue ID 唯一、依赖存在且无环、tracker 可写、验证/探索命令可识别；范围不确定时标记不确定。记录项目路径、Git 分支、modified/untracked/staged 基线、runId、protectedPaths、coverage/锁/evidence 路径。
- 展示输入来源、coordinator policy、issue DAG、并发上限、探索范围、完成条件、tracker 更新、保护边界、Git 基线、evidence 和
maxRepairRounds，等待用户确认。确认前不创建 team、不启动 sub agent、不修改 tracker 或工作区；确认后才创建一个原生AgentTeam。
探索派发与完成条件
确认后主 Agent 按 DAG 为每个 child issue 派发一次。prompt 遵循 context 卫生：只含 issue ID、tracker 文件路径、protectedPaths、探索命令、终态格式和一行目标摘要；issue 原文由 teammate 自行 Read。子 agent 只能调用 /wayfinder，只探索当前 issue，不调用实现技能，不实现代码或配置，不解锁后继。
Teammate 只报告一次终态事件，过程性消息一律禁止且无豁免（探索型不使用 CONFLICT 升级），进度只通过 tracker Status: 字段体现。tracker 文件按 issue 天然隔离，不产生写冲突。
探索或地图补充 issue 可以 resolved，但必须在 tracker 写入 ## Answer、Status: resolved 和可复核证据（命令、路径或共享上下文引用）。需要代码实现/配置变更的 issue 必须 blocked，写明 reason 和证据；不自动调用实现技能或偷偷修改代码。终态事件有硬上限（summary ≤ 2 行、超限内容按双轨落盘只留路径）。只有主 Agent 独立核验 Answer、Status、证据后才释放后继。
DAG、并发与失败传播
状态流转为 pending → running → verifying → resolved，失败或阻塞转为 failed/blocked。每轮选择所有依赖已核验为 resolved 的 ready issue，在 maxConcurrency 上限内全量并发派发；不做调度期路径检查（ADR-0001）。coverage、锁、evidence、protectedPaths 和用户既有改动受保护。
收到 failed/blocked 或核验失败时，主 Agent 在共享上下文写一行事件摘要加指针（详情落盘到 evidenceDir/<issue>.failed.md），只沿依赖后代传播 blocked，后代派发 prompt 只引用指针路径；独立分支继续。恢复需用户批准并重建基线，不自动 retry、reset、rollback、stash、合并或删除证据。缺失、重复、格式错误、ID 不匹配、tracker 未更新、验证/evidence 不可复核或异常退出均 fail-closed。
收尾
map 完成要求所有 child issue tracker 都是 Status: resolved，且每项均有 ## Answer 与证据。主 Agent 回收已完成 team task，保留共享上下文与 evidence，生成 evidenceDir/report.md 全量明细（tracker、状态、Answer、verification、evidence、失败/阻塞原因和未完成依赖）；对话中只输出简表（issue / 状态 / 一行结论）加 report 路径。已完成 issue 不重复启动。
References
- map 与 child issue 规则：
references/map-issues.md - manifest 与终态协议指针：
references/manifest-template.md - 公共 AgentTeam 协议（含 context 卫生）：
docs/agents/agent-team-protocol.md - 移除静态任务范围声明、改运行时冲突升级的决策：
docs/adr/0001-remove-allowedpaths-runtime-conflict-escalation.md
