Deep Research Skill

一个可复用的 Deep Research Skill：输入一个明确的研究问题，经过输入门控 + 六步流程（元思考、问题拆解、资料检索、来源精读、证据综合、报告撰写），输出一份结论可追溯、证据分层、不确定性显式标注的结构化研究报告。

出处与课程

本 Skill 是课程 Git4GenThinking 的课后作业成果（Issue 4：整理并提交可复用版本），在课程提供的框架与章节指导下完成：

• 课程仓库（开源）：https://www.gitlink.org.cn/Gitconomy/Git4GenThinking
• 对应章节：
  • 第 7 讲《打包与复用》：courses/course-sdd-engineering/lectures/markdown/ch07-package-and-reuse.md
  • 第 8 讲《进阶配置示例》：courses/course-sdd-engineering/lectures/markdown/ch08-advanced-config-example.md
• 对应 Issue：#82

规则体系（六步流程、输入门控、证据层级 T1/T2/T3、工具降级链）均源自该课程前三次作业的逐步迭代，感谢课程作者的设计与开源分享。

前置条件

• 一个支持 Markdown Skill 的 agent 宿主：OpenCode（本说明的示例），或 TraeCode / Claude Code 等同类环境。
• 可用的模型 provider（本包不内置任何 API Key）。
• 网络检索工具：Tavily API（首选）或内置 WebSearch/WebFetch；两者均不可用时仅依赖本地知识库。

安装

OpenCode：项目级安装

安装位置为项目的 .opencode/skills/deep-research/：

mkdir -p .opencode/skills/deep-research
cp -r deep-research-skill/* .opencode/skills/deep-research/

最小运行只需 SKILL.md 一个文件（它是自包含的）：

mkdir -p .opencode/skills/deep-research
cp deep-research-skill/SKILL.md .opencode/skills/deep-research/

验证目录结构：

ls .opencode/skills/deep-research/
# SKILL.md  README.md  CHANGELOG.md  references/  workflows/  tools/  knowledge-base/  examples/

OpenCode：全局安装（所有项目可用）

cp -r deep-research-skill ~/.config/opencode/skills/deep-research

其他宿主

把 SKILL.md 放到该宿主读取 Skill 的目录（如 TraeCode 的项目/全局 skills 路径），或在对话中让 agent 读取并遵守 SKILL.md 全文。Skill 的规则与流程均为纯 Markdown，不依赖特定运行时。

使用

1. 在项目中启动 agent，加载本 Skill（OpenCode 中说”加载 deep-research”，或由系统按描述自动触发）。
2. 给出一句话研究问题，可附关注维度、深度、来源偏好。
3. 若问题过大，Skill 会先给收窄方向并等待；问题明确则直接开始。
4. 获取四部分报告：检索状态声明 / 研究结论 / 资料来源 / 待确认事项。

示例

输入：

YOLOv8 与 RT-DETR 在实时目标检测中的核心差异是什么？

输出（摘要，完整自测见 examples/example.md）：

干净环境（OpenCode 原生、仅安装 SKILL.md）实跑产出的完整报告见 examples/clean-test-report-yolov8-vs-rtdetr.md。

• 结论：YOLOv8 是 anchor-free 单阶段密集预测检测器；RT-DETR 是去掉 NMS 的实时 DETR 变体，二者在架构、后处理依赖、速度-精度权衡上存在系统性差异（具体结论以已精读的 T1/T2 来源为准）。
• 每条结论挂论文原文/官方仓库并标注 T1/T2/T3。
• 待确认：未能读到原文的方法细节、来源间冲突的数字均显式列出。

目录结构

目录/文件	作用
SKILL.md	Skill 行为定义（核心，自包含，单独复制即可运行）
README.md	安装与使用说明（本文件）
CHANGELOG.md	版本变更记录
references/	报告模板、评估标准、证据规则、迭代检查清单
workflows/	六步研究流程详版（含输入门控步骤 0）
tools/	搜索工具与本地知识库配置
knowledge-base/	本地资料源、索引、证据卡片
examples/	使用示例与干净环境自测记录

已知限制

1. 依赖网络检索，无法访问付费或需登录的内容。
2. 研究深度受模型上下文长度限制，超大主题需拆分。
3. 不保证覆盖所有重要来源；热门话题 T3 二手内容较多，须优先 T1/T2。
4. 门控与证据规则为自然语言约束、依赖模型自觉，无机器强制闸门。
5. 不适用于需要实时数据或需要执行外部操作的任务。

维护

• 更新知识库：往 knowledge-base/sources/ 添加资料，同步更新 knowledge-base/index.md。
• 更新证据卡片：资料更新后同步更新 knowledge-base/evidence-cards/ 对应卡片。
• 版本管理：遵循语义化版本号（主版本.次版本.修订号），记录见 CHANGELOG.md。