研究技能

说明

围绕某一主题开展开放式研究，并构建一份持续演进的 Markdown 文档。对话本身是临时性的；真正重要的是这份文档。

触发条件

当用户希望执行以下操作时启用：

• 研究某个主题、想法或问题
• 在决定正式构建前，先行探索某项内容
• 调研不同选项、模式或方法论
• 创建一份“研究文档”（research doc）或“调查报告”（investigation）
• 对复杂主题执行深度异步研究

研究目录结构

每个研究主题独占一个文件夹：

~/.openclaw/workspace/research//
├── prompt.md          # 原始研究问题 / 提示词
├── research.md        # 主要发现（并行输出或交互式笔记）
├── research.pdf       # PDF 导出文件（生成后存在）
└── ...                # 其他相关文件（数据、图片等）

两种研究模式

1. 交互式研究（默认模式）

适用于你与用户在对话中共同探索的主题。你将实时进行搜索、综合信息，并同步更新文档。

2. 深度研究（异步模式）

适用于需全面深入调查的复杂主题。通过 parallel-research CLI 调用 Parallel AI API。耗时数分钟至数小时，返回详尽的 Markdown 报告。

适用深度研究的场景：

• 市场分析、竞品格局评估
• 需要大量资料采集的技术深挖
• 多维度、多角度受益于并行探索的问题
• 用户明确要求“深度研究”，或强调需覆盖全面性

交互式研究工作流

1. 初始化研究

1. 创建研究文件夹：路径为 ~/.openclaw/workspace/research//

2. 创建 prompt.md，记录原始问题：

   # <主题标题>
   
   > <核心问题或好奇心>
   
   **Started:** <日期>
   

3. 创建 research.md，采用标准工作结构：

   # <主题标题>
   
   **Status:** Active Research
   **Started:** <日期>
   **Last Updated:** <日期>
   
   ---
   
   ## Open Questions
   - <待探索的初始问题>
   
   ## Findings
   
   
   ## Options / Approaches
   
   
   ## Resources
   
   
   ## Next Steps
   
   

4. 向用户确认 —— 展示文件夹已成功创建，并询问首先探索哪个方向。

2. 研究循环

每次交互中执行以下步骤：

1. 执行研究 —— Web 搜索、获取文档、浏览代码等
2. 更新文档 —— 补充新发现、将已解答问题移出 Open Questions、添加引用来源
3. 展示进展 —— 说明本次新增内容（无需重复全部细节）
4. 引导下一步 —— 以提问或建议结尾

关键行为准则：

• 优先更新已有章节，而非新建章节
• 发现项使用项目符号（bullet points），总结性内容使用段落叙述
• 标注不确定性（例如：“似乎……”、“根据 X 的说法……”、“尚未验证”）
• 尽可能为所有主张提供可点击的来源链接

3. 综合检查点

每完成 5–10 轮交互后，主动提供以下服务：

• 撰写一份“当前认知”（Current Understanding）摘要
• 清理冗余或重复的发现
• 若文档结构变得难以维护，则重新组织
• 识别潜在盲点（blind spots）

4. 完成研究

当研究结束时，在 research.md 中更新状态字段：

• "Status: Complete" —— 已完成，作为参考资料长期保留
• "Status: Ongoing" —— 活文档（living doc），将持续更新

若该研究明确服务于后续项目构建：

• 升级为项目规格文档：~/specs/.md
• 或直接基于研究成果创建新项目
• 将状态更新为 "Status: Graduated → ~/specs/..."

大多数研究仅用于知识沉淀，无需转化为规格文档。仅当确实要基于其构建实际项目时，才执行“升级”操作。

深度研究工作流

1. 启动深度研究

parallel-research create "你的研究问题" --processor ultra --wait

处理器选项：

• lite、base、core、pro、ultra（默认）、ultra2x、ultra4x、ultra8x
• 添加 -fast 后缀可提升速度、降低深度：如 ultra-fast、pro-fast 等

常用参数：

• -w, --wait —— 阻塞等待任务完成，并直接显示结果
• -p, --processor —— 指定处理器等级
• -j, --json —— 输出原始 JSON 格式结果

2. 自动轮询检查（可选）

深度研究任务通常耗时数分钟至数小时。推荐设置自动轮询机制，避免手动反复检查。

支持方式：

• OpenClaw 用户：参见 OPENCLAW.md 中基于 cron 的自动检查调度配置
• 其他部署环境：可使用任意调度器（cron、systemd timer、CI job）周期性执行 parallel-research status 和 parallel-research result ，直至任务完成
• 简易方式：直接使用 parallel-research create "..." --wait 阻塞等待（适用于较短任务）

3. 手动检查（按需）

parallel-research status 
parallel-research result 

4. 保存至研究文件夹

创建对应研究文件夹，并存入结果：

~/.openclaw/workspace/research//
├── prompt.md          # 原始问题 + 运行元数据
├── research.md        # 完整的 Parallel 输出

prompt.md 应包含如下内容：

# <主题标题>

> <原始研究问题>

**Run ID:** 
**Processor:** 
**Started:** <日期>
**Completed:** <日期>

research.md 包含完整的 Parallel 输出结果，并可附加后续补充说明。

PDF 导出

所有 PDF 文件必须保存至研究文件夹内 —— 绝不可保存至 tmp/ 目录。无论使用 export-pdf 脚本、浏览器 pdf 动作，或其他任何导出方式，最终输出路径均须为 research//。

使用 export-pdf 脚本将研究文档转换为 PDF：

export-pdf ~/.openclaw/workspace/research//research.md
# 输出路径：~/.openclaw/workspace/research//research.pdf

对于浏览器生成的 PDF（例如网页另存为 PDF）：

browser pdf → 保存至 research//<描述性文件名>.pdf

注意：表格渲染为纵向堆叠行（PyMuPDF 限制）。此效果在研究文档中可接受。

命令列表

• "new research: " —— 启动交互式研究文档
• "deep research: " —— 启动异步深度研究
• "show doc" / "show research" —— 显示当前研究文档内容
• "summarize" —— 触发综合检查点
• "graduate" —— 将研究推进至下一阶段（如项目规格）
• "archive" —— 标记为已完成的参考文档
• "export pdf" —— 导出为 PDF
• "check research" —— 查询待处理的深度研究任务状态

文档编写原则

• 原子化发现 —— 每个项目符号仅承载一项独立洞见
• 全面链接 —— 所有主张均应附带来源链接（文档、仓库、网站等）
• 保留上下文 —— 记录“为何选择研究此项？”
• 标注可信度 —— 存在不确定性时，明确使用限定词
• 标记关键发现时间 —— 尤其适用于快速演进的主题（如前沿技术）

环境准备

首次安装请参阅 SETUP.md，其中涵盖：

• parallel-research CLI 工具
• PDF 导出工具（pandoc、PyMuPDF）