菜单
Spec 创建前的信息收集与探索。由角色 spec-explorer 调用。 触发条件：(1) 角色 spec-explorer 需要在 Spec 创建前收集背景信息， (2) 需要检索历史经验（exp-search）， (3) 需要探索项目代码库、外部文档或第三方库， (4) TeamLead 通知 spec-explorer 开始工作。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/HHU3637kr/skills --skill spec-explore命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
当用户开始新的开发任务、需要启动完整 Spec 流程（需求对齐→探索→设计→实现→测试→收尾）， 或需要为一个新 Spec 创建协作上下文和 GitHub Flow 工作分支时使用。 不要用于已有完成 Spec 的小迭代（用 spec-update）或项目首次初始化（用 spec-init）。
当用户要求以「Agent 主控 + 全程 spawn 子 Agent」的方式启动 R&K Flow 开发流程时使用： 当前 Agent 只做编排（账本、门禁代问、批次调度），七个角色的实质工作一律交子 Agent 执行。 典型信号：用户说"用 swarm 模式启动"/"蜂群模式"/"所有任务都 spawn 子 Agent 做"/"你只做主控不要自己写代码"。 本 Skill 只做前置校验、写入 execution 字段、声明编排硬约束，随后委派 spec-start 跑既有五阶段流程。 不要用于运行时不支持子 Agent 的环境（退回 spec-start 串行路径）、已有活跃 Spec 的小迭代（用 spec-update）， 也不要用它替代 spec-start —— 流程本体、账本模板、门禁定义仍由 spec-start 唯一承载。
当 spec-start 需要为新 Spec 创建 GitHub Flow 工作分支，spec-update 需要复用/校验当前 Spec 分支，或 spec-end/spec-update 需要提交、推送、创建 PR、合并后清理分支时使用。也用于发版管理：建立或维护 release 分支、打版本 tag、发补丁版本、把修复 cherry-pick 到多条发布线、核对 tag 与分支是否错位、对齐镜像标签与 git tag、清理带版本号的旧分支。不要用于单次查看 git 状态、普通 diff 查询，或用户明确要求不走 GitHub Flow 的临时操作。
基于 SOC 职业分类
正在显示 SKILL.md
| disable-model-invocation | true |
| name | spec-explore |
| description | Spec 创建前的信息收集与探索。由角色 spec-explorer 调用。 触发条件：(1) 角色 spec-explorer 需要在 Spec 创建前收集背景信息， (2) 需要检索历史经验（exp-search）， (3) 需要探索项目代码库、外部文档或第三方库， (4) TeamLead 通知 spec-explorer 开始工作。 |
进入工作流程前先对齐这张表。它把本 Skill 当成一个有边界的循环单元：明确读什么、能动什么、怎么算完成、什么时候停、什么时候交还给人。
| 项 | 本 Skill 的约定 |
|---|---|
| 输入 | TeamLead 的任务描述与探索范围、exp-search 检索结果、项目代码、外部库/文档 |
| 权限 | 只读探索（Read/Glob/Grep）+ 探索新内容后调用 exp-reflect 沉淀知识；不改业务代码、不写 plan、不建测试 |
| 验证 | explorer/exploration-report.html 含历史经验、项目现状、外部知识、对下游的建议与已知风险 |
| 停止 | 报告四个章节齐备且足以让 spec-writer/spec-tester 开工即停止，不为"探索更全"无限扩大范围 |
| 升级 | 探索发现需求本身存在矛盾、范围远超任务、或触及权限/安全/数据风险时，停止探索并交回 TeamLead 由用户决策 |
writer/plan.html 之前完成，为 spec-writer 和 spec-tester 提供充分背景explorer/exploration-report.html，遵循 html-report 契约（HTML + 共享样式表 + rk:* meta 双轨元信息 + data-rev 修订标记）| 情况 | 是否触发 exp-reflect |
|---|---|
| 调用 exp-search 检索已有经验 | ❌ 不触发 |
| 探索项目现有代码库 | ✅ 触发（知识记忆） |
| 探索外部代码库（如第三方库） | ✅ 触发（知识记忆） |
| 阅读外部技术文档 | ✅ 触发（知识记忆） |
从 TeamLead 的启动指令中获取：
explorer/exploration-report.html 的保存路径/exp-search <关键词>
以任务关键词检索，阅读相关经验，记录可参考的历史解决方案。
根据任务需要，探索相关代码：
Grep 查找相关代码模式Read 阅读关键文件Glob 了解目录结构探索完成后触发 exp-reflect：探索项目代码后，将新发现调用 exp-reflect 沉淀为知识记忆（记忆文件保持 .md）。
探索外部代码库（如 AgentScope、第三方库）或技术文档。
探索完成后触发 exp-reflect：探索外部资源后，调用 exp-reflect 将关键发现沉淀为知识记忆（记忆文件保持 .md）。
在当前 Spec 目录下创建 explorer/exploration-report.html，遵循 html-report skill 的固定骨架。要求：
<head> 的 rk:* meta / rk-* link 机器可读，.rk-meta 人可读镜像（含基准分支与 PR）rk-verdict 一句话前置：探索是否足以支撑 spec-writer 开工rk-cal risk 单独成块，不要埋在正文段落里；关键取舍用 rk-cal key，需 spec-tester 重点覆盖的边界用 rk-cal warn<span class="rk-ref">path:line</span>rk-links 写本报告引用的经验/知识与账本，rk-backlinks 写引用本报告的 plan / test-plan（尚未产出时在 rk-links 标注（待创建），产出后补齐反链）按 D-002（…）），纯笔误/措辞/补充说明直接写清，不编造编号；决策过程正文留在 lead/team-context.md 的「决策记录」，不复制进报告<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>探索报告 - {任务描述}</title>
<meta name="rk:type" content="exploration-report">
<meta name="rk:spec-dir" content="spec/{XX-分类}/{YYYYMMDD-HHMM-任务描述}">
<meta name="rk:role" content="spec-explorer">
<meta name="rk:mode" content="{gated|autopilot}">
<meta name="rk:created" content="{YYYY-MM-DD}">
<meta name="rk:updated" content="{YYYY-MM-DD}">
<meta name="rk:revision" content="1">
<meta name="rk:git-branch" =>
探索报告：{任务描述}
类型 exploration-report
Spec spec/{XX-分类}/{YYYYMMDD-HHMM-任务描述}
角色 spec-explorer
分支 {git_branch} ← {base_branch}
PR {pr_url 或 —}
创建 {YYYY-MM-DD}
修订 r1（{YYYY-MM-DD}）
探索结论
{一句话：探索到什么程度、下游能否直接开工、最大的不确定性是什么}
修订历史
修订日期修改人改了什么原因
r1{YYYY-MM-DD}spec-explorer初版—
r2{YYYY-MM-DD}spec-explorer{哪句改成了什么}按 D-002（{一句话决策摘要}）／或直接写清非决策性原因
检索到的历史经验
{exp-search 结果摘要}
项目现状分析
{相关代码/模块的理解：当前实现、接口、数据结构}
关键位置：src/xxx/yyy.ts:120
外部知识
{探索外部库/文档的关键发现}
对 Spec 创建的建议
建议的实现方向：{…}
可复用的现有组件：{…}
关键决策{建议下游采纳的方向及理由}
已知风险与边界情况
风险{风险 1：现象、触发条件、对下游的影响}
风险{风险 2}
注意{需要 spec-tester 特别覆盖的边界情况}
关联产物
本报告引用
{经验标题}
{知识标题}
运行账本
引用本报告
设计方案（待创建）
测试计划（待创建）
先更新当前 Spec 的 lead/team-context.md 共享区：
doneexplorer/exploration-report.htmlspec-explorerprocess / dependency / scope通知 TeamLead：
- explorer/exploration-report.html 已完成，路径：{路径}
- 建议下游角色：spec-writer、spec-tester
- 需要传递给下游的重点风险/边界：[简述]
TeamLead → spec-explorer 开始
spec-explorer → exp-search（检索） + 代码探索 + 外部资源探索
spec-explorer → explorer/exploration-report.html
spec-explorer → TeamLead → spec-writer / spec-tester
完成探索后确认：
explorer/exploration-report.html 已在正确路径创建lead/team-context.md 的「任务进度」中自己的任务行，必要时补「问题闭环记录」writer/plan.html / tester/test-plan.html 产出后，已回到本报告 rk-backlinks 去掉「待创建」标注，补齐反向关联explorer/exploration-report.html 内容太简略，spec-writer 缺少背景信息rk-links 却漏了 rk-backlinks，下游报告产出后无法从探索报告发现引用方.rk-meta 却漏了 <head> 的 rk:* meta（或反之），元信息双轨不完整file:// 直接打开时丢样式