菜单
系统化学习材料生成器。给一个新领域/技术/概念，AI 自主调研、搭体系、产出 HTML 学习材料（含骨架/案例/工程化/争议+盲区）。当用户说"我要学 X / 帮我系统拆解 X / 我想吃透 X 这个领域 / 给我整理 X 的全貌 / 深度调研 X 给我系统讲讲 / 把 X 搞透"时触发。不适用于"X 行不行/为什么 Y"（用 long-research）、"X 有哪些好玩案例"（用 case-radar 给散点）、"把这堆素材整理成 HTML"（用 readable-output 处理已有素材）、文章写作（用 writing-assistant）、设计稿（用 design-exploration）。
帮助梳理一份"框架计划报告"(项目 v1.0 计划、版本路线、阶段方案等)。通过"摸现实 → 定文档类型 → 搭骨架 → 填内容 → 统一结构 → 语言精修 → 自检" 7 步引导,产出"讲为什么做 / 做到什么程度算完 / 分几步走"的框架计划,而不是功能清单或技术方案。当用户说"写计划报告"、"项目计划"、"框架计划"、"v1.0 计划"、"版本路线"、"阶段方案"、"plan-report"、"/plan-report"时触发。
陪伴型 AI 人设生成与优化流程。当用户想给 Hermes Agent（或任意 AI 陪伴角色）做一个"有感情、聊久不掉、像真人"的人设时使用。通过"定调子 → 名字 → 外形 → 性格 → 背景 → 关系 → 说话节奏 → 生成 SOUL.md → 迭代"的结构化对话，从一句模糊想法（如"我想要个JK女友""年上男友""高冷御姐"）产出可直接贴进 Hermes SOUL.md 的第一人称人设文本。支持女友/男友/各种气质的陪伴角色，并让用户选择"一句一句发"还是"整段说"的输出风格。当用户说"做个人设/捏个AI女友男友/给Hermes弄个角色/优化人设/换个人设"时触发。
PRD + 可执行测试用例双文档一体化协作。与用户共同写并迭代。理解需求后自主读代码再写；故事驱动 + 分阶段单点确认；每个 PRD 产出 PRD-MD 与 测试用例-MD（给 AI 的事实源）+ 两份套模板的 review HTML（给人查阅，与 MD 严格 1:1）。触发：梳理/撰写/完善 PRD、需求文档、用户故事、验收标准、测试用例、测试基准、测试方案。
把当前对话的上下文 / 一堆历史内容 / 散落的信息**整理成可读性高的 HTML 总结**。强制 4 问挖掘（给谁看 / 读完拿什么 / 详略 / 风格）+ 6 阶段框架（定终点 → 抓核心点 → 选主结构 → 写 → 自检），让 AI "想清楚再输出"，避免散文式罗列。当用户说"做个复盘"、"汇总一下"、"总结这堆"、"整理成 HTML"、"把上下文整理一份"、"做个教程 / 学习指南 / 报告"、"把 X 讲清楚"等需要把上下文/历史输出成给人读的中长 HTML 时触发。
案例雷达。给一个新东西（新工具/新概念/新生态），扫一遍生态找好玩的真实案例，重点是抓"真物"（截图/源码/演示）而不是 GitHub 主页，输出可浏览的 HTML 案例集。当用户说"看看大家用 X 做了什么"、"扫一下 X 生态"、"市面上 X 有什么新玩法"、"给我看 X 的真物案例"、"/case-radar"时触发。不适合：① 已有明确目标的深度调研（用 long-research）② 写文章/出 PRD（用 writing-assistant / prd-doc-writer）③ 单纯求知不需要 HTML（直接问就好）。
复杂长程任务的自主执行流程。当用户有一个复杂或模糊的任务（"帮我搞清楚 X / 帮我评估 Y / 帮我把这堆东西整理出来 / 帮我对比 N 个方案 / 帮我跑一次调研"），希望 AI 自己拆解、自己执行、自己校验、只在关键时刻找用户的场景。通过"任务确认 → 任务队列 → 分批执行 → 周期校验队列 → 触发式汇报"实现 1-2 小时无人值守的自主执行。当用户说"帮我搞清楚 / 评估一下 / 整理一下 / 对比一下 / 跑一次调研 / 你自己跑别打扰我 / 长程任务 / 自主跑"时触发。**不适用于**：UI 设计（用 design-exploration）、待办优先级（用 priority-judge）、文章写作（用 writing-assistant）、需求池管理（用 backlog-manager）、终局发散（用 vision-exploration）、起名（用 product-naming）、有明确 spec 的实现编码任务（直接编码）。
| name | system-study |
| description | 系统化学习材料生成器。给一个新领域/技术/概念，AI 自主调研、搭体系、产出 HTML 学习材料（含骨架/案例/工程化/争议+盲区）。当用户说"我要学 X / 帮我系统拆解 X / 我想吃透 X 这个领域 / 给我整理 X 的全貌 / 深度调研 X 给我系统讲讲 / 把 X 搞透"时触发。不适用于"X 行不行/为什么 Y"（用 long-research）、"X 有哪些好玩案例"（用 case-radar 给散点）、"把这堆素材整理成 HTML"（用 readable-output 处理已有素材）、文章写作（用 writing-assistant）、设计稿（用 design-exploration）。 |
你要学一个新领域。AI 自主调研 + 搭体系 + 产出 HTML 学习材料。
和已有 skill 的本质区别：
这个 skill 的差异化命门：除了"骨架 + 案例 + 工程化"这些教科书必讲的部分，强制产出"争议焦点 + 盲区清单"两块——这是普通学习材料没有的，是用户研究 → 内容/产品的金矿。
| 阶段 | 名称 | 介入次数 | 产物 | 详细操作 |
|---|---|---|---|---|
| 1 | 题目收敛 | 1 次（必） | 01-题目确认.md | reference/stage-1-topic-narrow.md |
| 2 | 调研计划 | 1 次（默认） | 02-调研计划.md | reference/stage-2-research-plan.md |
| 3 | Sub-agent 并行调研 | 0 次 | 03-调研笔记/A-E.md | reference/stage-3-subagent-templates.md ⭐ |
| 4 | 体系搭建+大纲确认 | 1 次（默认） | 04-体系大纲.md | reference/stage-4-synthesis.md |
| 5 | HTML 学习材料 | 0 次 | 05-学习材料.html | reference/stage-5-html-spec.md |
默认严格逻辑：阶段 1/2/4 都问用户。但用户可一次性说"全程不打扰、直接出 HTML"，跳过 2、4。阶段 1 永远不能省——题目错了后面全白干。
如果用户在阶段 1 / 2 / 任何阶段说出"你直接来吧 / 直接给我结果就行 / 你自己定 / 你判断 / 全程不打扰"——主线程立即切换到快速通道：
02-调研计划.md 存档，但不再问用户，直接进阶段 304-体系大纲.md 存档，但不再问用户，直接进阶段 5切换条件：用户的话里明确包含"直接 / 不打扰 / 自己定 / 自己判断 / 你来"等授权词。模糊表达（如"看着办"）不算——继续按默认严格流程问。
这 5 条是从首发实战提炼的、贯穿整个 skill 的设计哲学。所有 stage 都遵循：
详细 prompt 模板见 reference/stage-3-subagent-templates.md。
| Agent | 固定职责 | 主题适配方式 |
|---|---|---|
| A 骨架 | 官方文档 + 学派 / 主流方法 | 视主题决定具体源（提示词→Anthropic/OpenAI 文档；记忆系统→各家 memory 文档；MCP→协议文档+实现） |
| B 前沿 | 新形态、新趋势、最新讨论 | 视主题灵活——一句话定义"这领域最新的是什么" |
| C 真物 | 顶级案例 / 真实代码 / 原文拆解 | 必须看原文；案例数量按可信源能找到几个定 |
| D 生态 | 工具景观 / 工程化 / 应用场景 | 直接对接用户的产品决策 |
| E 争议+盲区 | 必选，强制双轨陈述 + 给倾向分 + 盲区清单 | 差异化命门——和市面学习材料的核心区别 |
主线程拿到题目后，根据主题情况微调每个 sub-agent 的具体调研范围（不是改职责类型，是改"查哪些源"），再批量派出。
<主题>学习/ # 默认目录名，可改
├── PLAN.md # 总控
├── 01-题目确认.md
├── 02-调研计划.md
├── 03-调研笔记/
│ ├── A-{骨架切片名}.md
│ ├── B-{前沿切片名}.md
│ ├── C-{真物切片名}.md
│ ├── D-{生态切片名}.md
│ └── E-争议与盲区.md
├── 04-体系大纲.md
└── 05-学习材料.html
AskUserQuestion（multiSelect: true）给用户 4 个切片选项让她勾01-题目确认.md 记录主题 + 学习视角02-调研计划.md04-体系大纲.md| 参数 | 默认 | 可调 |
|---|---|---|
| 切片数量 | 4（A-D）+ 1（E）= 5 | 3-6（E 必含） |
| 介入级别 | 阶段 1/2/4 各一次 | 用户可授权全跳过 2 和 4 |
| 产物目录名 | <主题>学习/ | 用户可改 |
| HTML 风格 | 浅色暖白 | 可扩深色 / 暗紫调（暂未实现） |
| Sub-agent 派出方式 | 一次性 5 个并行 | 不要分两批 |
long-researchcase-radar（散点 vs 体系）readable-output（处理已有素材 vs 自己挖素材）writing-assistantdesign-exploration / macos-product-designprd-doc-writer首发实战：项目根目录 提示词学习/（2026-05-14 跑通的真实案例）
后续每跑一个新主题，建议在 examples-index.md 里记一笔，作为后续主题的参考。