research-deep

1# Research Deep - 深度调研
2 
3## 触发方式
4`/research-deep`
5 
6## 执行流程
7 
8### Step 1: 自动定位Outline
9在当前工作目录查找 `*/outline.yaml` 文件，读取items列表、execution配置（含items_per_agent）。
10 
11### Step 2: 断点续传检查
12- 检查output_dir下已完成的JSON文件
13- 跳过已完成的items
14 
15### Step 3: 分批执行
16- 按batch_size分批（完成一批需要得到用户同意才可进行下一批）
17- 每个agent负责items_per_agent个项目
18- 启动web-search-agent（后台并行，禁用task output）
19 
20**参数获取**：
21- `{topic}`: outline.yaml中的topic字段
22- `{item_name}`: item的name字段
23- `{item_related_info}`: item的完整yaml内容（name + category + description等）
24- `{output_dir}`: outline.yaml中execution.output_dir（默认./results）
25- `{fields_path}`: {topic}/fields.yaml的绝对路径
26- `{output_path}`: {output_dir}/{item_name_slug}.json的绝对路径（slugify处理item_name：空格替换为_，移除特殊字符）
27 
28**硬约束**：以下prompt必须严格复述，仅替换{xxx}中的变量，禁止改写结构或措辞。
29 
30**Prompt模板**：
31```python
32prompt = f"""## 任务
33调研 {item_related_info}，输出结构化JSON到 {output_path}
34 
35## 字段定义
36读取 {fields_path} 获取所有字段定义
37 
38## 输出要求
391. 按fields.yaml定义的字段输出JSON
402. 不确定的字段值标注[不确定]
413. JSON末尾添加uncertain数组，列出所有不确定的字段名
424. 所有字段值必须使用中文输出（调研过程可用英文，但最终JSON值为中文）
43 
44## 输出路径
45{output_path}
46 
47## 验证
48完成JSON输出后，运行验证脚本确保字段完整覆盖：
49python ~/.claude/skills/research/validate_json.py -f {fields_path} -j {output_path}
50验证通过后才算完成任务。
51"""
52```
53 
54**One-shot示例**（假设调研GitHub Copilot）：
55```
56## 任务
57调研 name: GitHub Copilot
58category: 国际产品
59description: Microsoft/GitHub开发，首个主流AI编程助手，市场份额约40%，输出结构化JSON到 {project_dir}/results/GitHub_Copilot.json
60 
61## 字段定义
62读取 {project_dir}/fields.yaml 获取所有字段定义
63 
64## 输出要求
651. 按fields.yaml定义的字段输出JSON
662. 不确定的字段值标注[不确定]
673. JSON末尾添加uncertain数组，列出所有不确定的字段名
68…