/SKILL.md

name, user-invocable, allowed-tools, description

name	user-invocable	allowed-tools	description
research	true	Read, Write, Glob, WebSearch, Task, AskUserQuestion	对某一主题进行初步调研，并生成调研大纲。适用于学术调研、竞品调研、技术选型等场景。

调研技能 —— 初步调研

触发方式

/research <主题>

工作流程

步骤 1：基于模型知识生成初始框架

根据主题，利用模型已有知识生成：

• 该领域的主要研究对象/条目列表
• 建议的调研领域框架

输出 {step1_output}，使用 AskUserQuestion 确认：

• 是否需要增删条目？
• 领域框架是否满足需求？

步骤 2：网络搜索补充

使用 AskUserQuestion 询问时间范围（例如：最近 6 个月、2024 年以来、不限时间）。

参数获取：

• {topic}：用户输入的调研主题
• {YYYY-MM-DD}：当前日期
• {step1_output}：步骤 1 的完整输出
• {time_range}：用户指定的时间范围

硬性约束：以下提示词必须严格复现，仅替换 {xxx} 中的变量，不得修改结构或措辞。

启动 1 个 web-search-agent（后台），提示词模板：

prompt = f"""## 任务
调研主题：{topic}
当前日期：{YYYY-MM-DD}

基于以下初始框架，补充最新条目与建议的调研领域。

## 现有框架
{step1_output}

## 目标
1. 验证现有条目是否遗漏了重要对象
2. 根据遗漏对象补充条目
3. 在 {time_range} 内继续搜索与 {topic} 相关的条目并进行补充
4. 补充新领域

## 输出要求
直接返回结构化结果（不写入文件）：

### 补充条目
- 条目名称：简要说明（为何应添加该条目）
...

### 建议补充的领域
- 领域名称：领域描述（为何需要该维度）
...

### 来源
- [来源1](url1)
- [来源2](url2)
"""

一次性示例（假设调研 AI 编程历史）：

## 任务
调研主题：AI 编程历史
当前日期：2025-12-30

基于以下初始框架，补充最新条目与建议的调研领域。

## 现有框架
### 条目列表
1. GitHub Copilot：由 Microsoft/GitHub 开发，首款主流 AI 编程助手
2. Cursor：AI 优先的 IDE，基于 VSCode
...

### 领域框架
- 基本信息：名称、发布日期、公司
- 技术特性：底层模型、上下文窗口
...

## 目标
1. 验证现有条目是否遗漏了重要对象
2. 根据遗漏对象补充条目
3. 在 since 2024 内继续搜索与 AI 编程历史 相关的条目并进行补充
4. 补充新领域

## 输出要求
直接返回结构化结果（不写入文件）：

### 补充条目
- 条目名称：简要说明（为何应添加该条目）
...

### 建议补充的领域
- 领域名称：领域描述（为何需要该维度）
...

### 来源
- [来源1](url1)
- [来源2](url2)

步骤 3：询问用户已有字段

使用 AskUserQuestion 询问用户是否已有字段定义文件，若有则读取并合并。

步骤 4：生成大纲（独立文件）

合并 {step1_output}、{step2_output} 及用户已有字段，生成两个文件：

outline.yaml（条目 + 配置）：

• topic：调研主题
• items：调研对象列表
• execution：
  • batch_size：并行 agent 数量（通过 AskUserQuestion 确认）
  • items_per_agent：每个 agent 处理的条目数（通过 AskUserQuestion 确认）
  • output_dir：结果输出目录（默认：./results）

fields.yaml（字段定义）：

• 字段类别与定义
• 每个字段的名称、描述、详细程度
• detail_level 层级：brief -> moderate -> detailed
• uncertain：不确定字段列表（预留字段，在深入阶段自动填充）

步骤 5：输出并确认

• 创建目录：./{topic_slug}/
• 保存：outline.yaml 和 fields.yaml
• 展示给用户确认

输出路径

{current_working_directory}/{topic_slug}/
  ├── outline.yaml    # 条目列表 + 执行配置
  └── fields.yaml     # 字段定义

后续命令

• /research-add-items —— 补充条目
• /research-add-fields —— 补充字段
• /research-deep —— 启动深入调研