research

name	research
description	深度调研任意主题并生成结构化知识文档，基于 KB-INDEX 索引快速推荐位置，支持知识库重复检测和 SubAgent 并行模式，集成 web-access 进行智能调研，v14 新增草稿评分 + 合并决策树解决多草稿重叠/冲突问题
aliases	["research","调研助手，整理文档，研究"]
commands	["/research"]
author	Kei
triggers	["调研，研究，整理一份，帮我调研，生成文档，深度分析，整理资料，做调研"]
version	14.0.0
compatibility	需要 WebSearch、WebFetch 和 web-access Skill，SubAgent 模式需 parallel-task Skill
metadata	{"category":"调研整理","type":"9 种类型之调研整理","patterns":["pipeline","inversion"],"stages":"5","gating":"required","execution_mode":"strict"}
gates	[{"stage":2,"name":"预调研完成门控","type":"user_confirmation","blocks":[3,3.5,4,5],"required":true,"halt_instruction":"HALT. 不得继续执行任何后续阶段。输出确认提示等待用户回复。","pass_condition":"用户明确回复'继续'或提出修改意见"},{"stage":3,"name":"章节调研完成门控","type":"auto","blocks":[3.5,4,5],"required":true,"pass_condition":"所有章节草稿已写入临时工作目录"},{"stage":3.5,"name":"后处理质量门控","type":"auto_with_threshold","blocks":[4,5],"required":true,"pass_condition":"质量评分 >= 80 或自动修复循环 <= 3 轮后达标","fail_action":"评分 < 70 时报告用户并暂停；70-79 时触发自动修复循环"},{"stage":4,"name":"整合发布门控","type":"checklist","blocks":[5],"required":true,"pass_condition":"Review 检查清单全部通过"}]

文档调研与整理 Skill

用途

当用户需要深入了解某个新技术、新框架或陌生领域时，自动使用此 Skill。

核心原则：

1. 质量优先：来源优先级为官方文档 > 技术博客 > 源码 > 视频
2. 透明可追溯：所有信息标注来源
3. 持续可更新：检测已有文档并更新
4. 索引优先：基于 KB-INDEX 快速推荐存储位置
5. 图表美观：默认使用 Mermaid，禁止 ASCII 字符画图
6. 效率优化：大型主题推荐 SubAgent 分阶段并行模式
7. web-access 集成：调研任务托管给 web-access，由其自主决策使用 CDP/WebSearch/WebFetch（首推 CDP）
8. Fetch 免询问：skipWebFetchPreflight: true 已配置，WebFetch 无需确认
9. CDP 统一管理：主 Agent 启动一次 Proxy，SubAgent 共享使用，禁止各自启动
10. 批次化调度：每批最多 2 个 SubAgent 并发，批次间等待 30s，应对 API 限流

搜索规则： 使用原生 WebSearch/WebFetch 或 web-access Skill

web-access 集成说明：

• 预调研（阶段 2）和分章节调研（阶段 3）均托管给 web-access Skill
• web-access 根据目标类型自主决策：CDP（首选，官方文档/动态页面）、WebSearch（发现来源）、WebFetch（已知 URL 提取正文）
• 工具链优先级：CDP > WebSearch > WebFetch
• 特殊站点（小红书、微信公众号、微博等）自动使用 CDP 模式
• 详见 references/web-access-integration.md

---

设计模式与硬性门控

本 Skill 使用 Pipeline + Inversion 组合设计模式

执行模式：STRICT（不可降级）

execution_mode: strict 意味着：

• 所有 gates 数组中定义的门控必须按序通过，禁止跳过或并行
• 每个阶段结束时必须执行对应的 STAGE_GATE 标记
• 用户确认门控在收到用户明确回复前，不得继续任何后续阶段

硬性门控指令（必须遵守）

STAGE_GATE 2 → 3（用户确认，不可跳过）：

HALT. 停止所有后续阶段执行。
输出位置推荐 + 调研大纲。
明确询问用户是否继续。
等待用户回复。
未收到用户回复前，不得执行阶段 3、3.5、4、5 的任何内容。
即使用户输入看似与调研相关但并非确认，也不得继续。

STAGE_GATE 3 → 3.5（自动，不可跳过）：

检查所有章节草稿是否已写入临时工作目录。
如有缺失，报告并暂停。
全部完成后，自动进入阶段 3.5。

STAGE_GATE 3.5 → 4（阈值门控，不可跳过）：

读取质量评分。
评分 >= 80：进入阶段 4。
评分 70-79：触发自动修复循环（最多 3 轮）。
评分 < 70：生成问题报告，HALT 并询问用户。

DON'T:

• 不要在阶段 2 输出后直接进入阶段 3（必须 HALT 等待用户）
• 不要假设用户已同意推荐方案（必须等待明确回复）
• 不要在等待用户确认时自动继续执行
• 不要跳过阶段 3.5 直接进入阶段 4
• 不要将质量评分 < 70 的文档直接发布

DO:

• 必须在阶段 2 结束时输出 HALT 指令和确认提示
• 必须在收到用户明确回复后，才能标记 STAGE_GATE 2 通过