Initial commit: Deep Research Skill for Claude Code

skills/research/SKILL.md

@@ -0,0 +1,41 @@
+---
+allowed-tools: Read, Write, Glob, WebSearch, Task, AskUserQuestion
+description: 对目标话题进行初步调研，生成调研outline。用于学术调研、benchmark调研、技术选型等场景。
+---
+
+# Research Skill - 初步调研
+
+## 触发方式
+`/research <topic>`
+
+## 执行流程
+
+### Step 1: 模型内部知识生成初步框架
+基于topic，利用模型已有知识生成：
+- 该领域的主要研究对象/items列表
+- 建议的调研字段框架
+
+### Step 2: Web Search补充
+启动1个web-search-agent（后台），根据topic自行设计搜索策略，补充最新的items和字段建议。
+
+### Step 3: 询问用户已有字段
+使用AskUserQuestion询问用户是否有已定义的字段文件，如有则读取并合并。
+
+### Step 4: 生成Outline
+合并所有信息，生成outline文件（YAML格式），包含：
+- topic和基础配置
+- items列表（调研对象）
+- fields定义（调研字段）
+- execution配置（批量大小等）
+
+### Step 5: 输出并确认
+- 保存到当前工作目录: `./{topic_slug}_outline.yaml`
+- 展示给用户确认
+
+## 输出路径
+`{当前工作目录}/{topic_slug}_outline.yaml`
+
+## 后续命令
+- `/research-add-items` - 补充items
+- `/research-add-fields` - 补充字段
+- `/research-deep` - 开始深度调研

skills/research/add-fields/SKILL.md

@@ -0,0 +1,30 @@
+---
+description: 向现有调研outline补充字段定义。
+allowed-tools: Bash, Read, Write, Glob, WebSearch, Task, AskUserQuestion
+---
+
+# Research Add Fields - 补充调研字段
+
+## 触发方式
+`/research-add-fields`
+
+## 执行流程
+
+### Step 1: 自动定位Outline
+在当前工作目录查找 `*_outline.yaml` 文件，自动读取现有fields定义。
+
+### Step 2: 获取补充来源
+询问用户选择：
+- **A. 用户直接输入**：用户提供字段名称和描述
+- **B. Web Search搜索**：启动agent搜索该领域常用字段
+
+### Step 3: 展示并确认
+- 展示建议的新字段列表
+- 用户确认哪些字段需要添加
+- 用户指定字段分类和detail_level
+
+### Step 4: 保存更新
+将确认的字段追加到outline，保存文件。
+
+## 输出
+更新后的outline文件（原地修改，需用户确认）

skills/research/add-items/SKILL.md

@@ -0,0 +1,28 @@
+---
+description: 向现有调研outline补充items（调研对象）。
+allowed-tools: Bash, Read, Write, Glob, WebSearch, Task, AskUserQuestion
+---
+
+# Research Add Items - 补充调研对象
+
+## 触发方式
+`/research-add-items`
+
+## 执行流程
+
+### Step 1: 自动定位Outline
+在当前工作目录查找 `*_outline.yaml` 文件，自动读取。
+
+### Step 2: 并行获取补充来源
+同时进行：
+- **A. 询问用户**：需要补充哪些items？有具体名称吗？
+- **B. 询问是否需要Web Search**：是否启动agent搜索更多items？
+
+### Step 3: 合并更新
+- 将新items追加到outline
+- 展示给用户确认
+- 避免重复
+- 保存更新后的outline
+
+## 输出
+更新后的outline文件（原地修改）

skills/research/deep/SKILL.md

@@ -0,0 +1,41 @@
+---
+description: 读取调研outline，为每个item启动独立agent进行深度调研。禁用task output。
+allowed-tools: Bash, Read, Write, Glob, WebSearch, Task
+---
+
+# Research Deep - 深度调研
+
+## 触发方式
+`/research-deep`
+
+## 执行流程
+
+### Step 1: 自动定位Outline
+在当前工作目录查找 `*_outline.yaml` 文件，读取items列表、fields定义、execution配置。
+
+### Step 2: 断点续传检查
+- 检查output_dir下已完成的JSON文件
+- 跳过已完成的items
+
+### Step 3: 分批执行
+- 按batch_size分批（默认5个）
+- 每个item启动1个web-search-agent（后台并行，禁用task output）
+- 每个agent读取outline获取字段定义
+- 输出结构化JSON到output_dir
+
+### Step 4: 等待与监控
+- 等待当前批次完成
+- 启动下一批
+- 显示进度
+
+### Step 5: 汇总报告
+全部完成后输出：
+- 完成数量
+- 失败/不确定标记的items
+- 输出目录
+
+## Agent配置
+- 每批并行: 5个agent（可在outline中配置）
+- 后台执行: 是
+- Task Output: 禁用（agent完成时有明确输出文件）
+- 断点续传: 是