主题分析技能

深度分析抽象主题、概念或技术，通过多代理研究和头脑风暴。产生带Mermaid图表的综合文档，转换为样式化的独立HTML报告。

阶段流程

初始化 → 研究 → 头脑风暴 → 文档 → 转换 → 完成

阶段1：初始化会话

创建会话目录

plans/sessions/{date}-analyze-{topic-slug}/
├── session.md          # 会话跟踪
├── research/           # 研究发现
├── docs/               # Markdown文档
└── report/             # 最终HTML输出
    └── index.html      # 样式化HTML报告

初始化会话文件

创建 session.md 包含：

主题描述
阶段跟踪表（初始化/研究/头脑风暴/文档/转换/完成）
完成检查清单

阶段2：研究阶段

代理委派（并行）

Task(docs-seeker, "研究外部文档：{topic}")
  → 保存到：research/external-docs.md

Task(pattern-researcher, "研究常见模式：{topic}")
  → 保存到：research/patterns.md

网络搜索

WebSearch("{topic} 最佳实践 2025")
WebSearch("{topic} 架构模式")

→ 保存到：research/current-trends.md

总结研究

Task(summarize-agent, "总结：research/")

→ 保存到：research/summary.md

关卡： 所有研究代理必须完成后才能继续。

阶段3：头脑风暴阶段

应用头脑风暴原则以深入理解：

一次一个问题 - 从不压倒
优先多项选择 - 提供具体选项
以推荐开头 - 解释推理
渐进验证 - 200-300字块

对话流程

理解 - 你感兴趣的方面？当前水平？要解决的问题？
边界 - 范围？相关主题？所需深度？
关键问题 - 要回答的最重要问题？
图表 - 哪些过程需要可视化？
验证 - 呈现提议结构，确认部分

捕获理解

记录在 research/brainstorm-notes.md：

用户意图（方面、水平、用例）
范围边界（包括/排除/深度）
关键问题回答
图表需求
约定结构

关卡： 用户必须确认分析方向后才能进行文档化。

阶段4：文档阶段

生成分析文档

使用模板创建 docs/analysis.md： templates/analysis-template.md

必填部分：

执行摘要
介绍（什么/为什么/术语）
核心概念
架构与设计（带Mermaid图表）
工作流与过程（带序列/状态图）
最佳实践
常见模式
陷阱与反模式
实施指南
资源与参考

Mermaid图表类型

类型	用例
`flowchart`	过程流、决策树
`sequenceDiagram`	交互、API调用
`stateDiagram-v2`	状态机、生命周期
`classDiagram`	对象关系
`erDiagram`	数据模型
`mindmap`	概念层次

关卡： Markdown必须包括所有必填部分和图表。

阶段5：HTML转换阶段

转换Markdown为HTML

使用模板：templates/html-template.html

解析markdown（标题、段落、列表、表格、代码块）
转换Mermaid块为 <div class="mermaid">
应用HTML结构带语义元素
嵌入CSS样式（专业、响应式）
包括Mermaid.js CDN用于图表渲染

Mermaid块转换

```mermaid
flowchart TD
    A --> B


变为：

```html
<div class="mermaid">
flowchart TD
    A --> B
</div>

关卡： HTML文件必须正确渲染，带工作Mermaid图表。

阶段6：完成阶段

最终输出结构

plans/sessions/{date}-analyze-{topic-slug}/
├── session.md              # 更新完成状态
├── research/
│   ├── external-docs.md
│   ├── patterns.md
│   ├── current-trends.md
│   ├── brainstorm-notes.md
│   └── summary.md
├── docs/
│   └── analysis.md
└── report/
    └── index.html          # 最终输出

宣布完成

分析完成

主题：{topic}
会话：plans/sessions/{session}/

HTML报告：report/index.html

查看：打开 plans/sessions/{session}/report/index.html

关键发现：
- [发现1]
- [发现2]
- [发现3]

质量关卡总结

阶段	关卡
初始化	会话目录创建
研究	所有代理完成
头脑风暴	用户确认方向
文档	Markdown带图表存在
转换	HTML正确渲染
完成	所有文件保存

错误处理

研究失败： 请求额外上下文或缩小范围
头脑风暴停滞： 询问具体澄清问题
HTML转换失败： 保存markdown，重试转换
主题太广： 提供缩小、概述或关注实施