القائمة
当用户要求"调研"、"深度调研"、"帮我研究"、"调研下这个"，或提到需要搜索、整理、汇总指定主题的技术内容时，应使用此技能。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when a request asks for a Chinese-first AI video script with shot plans, image prompts, narration, subtitles, or handoff contracts for scene generation, image generation, video assembly, or WeChat draft preparation.
Use when a Codex task needs native image generation or editing, especially a set, series, material kit, long image, multi-screen design, storyboard, carousel, or other deliverable requiring multiple consistent images.
Skill 开发指南。当用户需要创建新 Skill 或更新已有 Skill 时触发，提供标准化模板、目录规范和最佳实践。
Use when reviewing an agent Skill before sharing, installing, or executing it and when checking a Skill bundle for credentials, dangerous commands, suspicious network behavior, or obfuscated code.
This skill should be used when preparing Markdown articles for a WeChat Official Account draft box, selecting wenyan-cli themes, processing article images, or troubleshooting authentication and whitelist failures.
Fetch and summarize Feishu group chat history. Use when the user asks to read, review, or summarize messages from a Feishu group chat. Triggers: "看群聊记录", "群里聊了啥", "帮我看看这个群", "群消息历史", "chat history", "what did the group discuss". NOT for: sending messages (use message tool), reading documents (use feishu-doc skill), or wiki operations (use feishu-wiki skill).
| name | deep-research |
| description | 当用户要求"调研"、"深度调研"、"帮我研究"、"调研下这个"，或提到需要搜索、整理、汇总指定主题的技术内容时，应使用此技能。 |
| metadata | {"version":"1.0.0"} |
此技能用于对技术主题进行深度调研，输出专业的调研报告文档。
| 能力 | 说明 |
|---|---|
| 内容提取 | 从 URL、文档中提取核心信息 |
| 深度调研 | 联网搜索补充背景、对比、最新进展 |
| 报告生成 | 默认生成 Markdown 和 Word 两个版本 |
| 图解生成 | 为核心概念生成技术信息图 |
| Word 格式化 | 自动处理目录、标题加粗、表格实线等样式 |
当用户消息包含以下关键词时使用此技能：
每次调研任务必须同时提供：
每个调研主题创建独立文件夹，保持整洁：
{output_dir}/
├── Ralph-Loop/ # 主题文件夹（英文短横线命名）
│ ├── images/ # 该主题的信息图
│ │ ├── architecture.png
│ │ └── comparison.png
│ ├── Ralph-Loop调研报告.md # Markdown 报告
│ └── Ralph-Loop调研报告.docx # Word 报告
├── MCP-Protocol/
│ ├── images/
│ ├── MCP-Protocol调研报告.md
│ └── MCP-Protocol调研报告.docx
└── ...
命名规范：
Ralph-Loop、MCP-Protocol{主题名}调研报告.md 和 {主题名}调研报告.docximages/ 目录根据调研主题创建独立文件夹：
mkdir -p "{output_dir}/{主题名}/images"
使用 Task 工具进行联网搜索，补充：
使用预设风格脚本生成统一手绘风格的信息图。
| 内容类型 | 是否生图 | 图解类型 | 说明 |
|---|---|---|---|
| 核心架构/原理 | 必须 | arch | 系统结构、技术栈、模块组成 |
| 流程/步骤 | 必须 | flow | 工作流、执行顺序、操作步骤 |
| A vs B 对比 | 必须 | compare | 两种方案/技术的对比 |
| 3个以上要素 | 建议 | concept | 核心概念、多个方面组成 |
| 纯文字表格 | 不需要 | - | 用 Markdown 表格即可 |
| 代码示例 | 不需要 | - | 用代码块即可 |
所有配图统一使用手绘体可视化风格，保持系列一致性：
| 类型 | 命令参数 | 配色 | 布局 |
|---|---|---|---|
| 架构图 | -t arch | 科技蓝 #4A90D9 | 分层/模块化 |
| 流程图 | -t flow | 蓝+绿+橙 | 从上到下 |
| 对比图 | -t compare | 蓝 vs 橙 | 左右分栏 |
| 概念图 | -t concept | 蓝紫渐变 | 中心发散 |
使用 research_image.py 脚本生成：
# 架构图
python .opencode/skills/image-service/scripts/research_image.py \
-t arch \
-n "Ralph Loop 核心架构" \
-c "展示 Prompt、Agent、Stop Hook、Files 四个模块的循环关系" \
-o "{output_dir}/{主题名}/images/architecture.png"
# 流程图
python .opencode/skills/image-service/scripts/research_image.py \
-t flow \
-n "Stop Hook 工作流程" \
-c "Agent尝试退出、Hook触发、检查条件、允许或阻止退出的完整流程" \
-o "{output_dir}/{主题名}/images/flow.png"
# 对比图
python .opencode/skills/image-service/scripts/research_image.py \
-t compare \
-n "ReAct vs Ralph Loop" \
-c "左侧ReAct依赖自我评估停止，右侧Ralph使用外部Hook控制" \
-o "{output_dir}/{主题名}/images/comparison.png"
# 概念图
python .opencode/skills/image-service/scripts/research_image.py \
-t concept \
-n "状态持久化要素" \
-c "中心是Agent，周围是progress.txt、prd.json、Git历史、代码文件" \
-o "{output_dir}/{主题名}/images/concept.png"
| 图解类型 | 文件名 |
|---|---|
| 架构图 | architecture.png 或 {具体名称}_arch.png |
| 流程图 | flow.png 或 {具体名称}_flow.png |
| 对比图 | comparison.png 或 {A}_vs_{B}.png |
| 概念图 | concept.png 或 {具体名称}_concept.png |
按标准模板撰写 Markdown 报告，存放到主题文件夹：
{output_dir}/{主题名}/{主题名}调研报告.md
报告中引用图片使用相对路径：
# 进入主题目录
cd "{output_dir}/{主题名}"
# 生成 Word（--resource-path=. 确保图片正确引用）
# 注意：不要使用 --toc 参数，因为 Markdown 中已有手写目录
pandoc "{主题名}调研报告.md" -o "{主题名}调研报告.docx" --resource-path=.
# 格式化 Word
python ../../../.opencode/skills/deep-research/scripts/format_docx.py "{主题名}调研报告.docx"
调研报告的核心价值：深入研究、降低团队吸收成本、提供专家级建议。
---
date: YYYY-MM-DD
type: 调研报告
领域: {技术领域}
tags: [调研, {主题关键词}]
---
# XX调研报告
> 调研日期：YYYY年M月D日
---
## 目录
- 一、简介
- 二、启示
- 三、核心介绍
- 3.1 XXX
- 3.2 XXX
- 四、附录
- 4.1 详细文档
- 4.2 参考资料
---
## 一、简介
（快速说明调研内容，简短重点）
是什么，主要用来做什么，属于什么类别。有哪些能力，有什么特点。和竞品相比，有哪些区别，主打什么。
1. 要点一
2. 要点二
3. 要点三
---
## 二、启示
（调研内容带来的启示、值得学习借鉴之处、与现有产品如何结合、是否值得推荐）
1. 启示一
2. 启示二
3. 启示三
---
## 三、核心介绍
（正文部分，详细说明调研内容的原理/搭建/操作/使用过程，含信息图及流程说明）
### 3.1 XXX
上图展示了...（图解说明，让读者看图就能理解）
详细内容...
### 3.2 XXX
详细内容...
---
## 四、附录
### 4.1 详细文档
（更详细的配置/操作过程）
### 4.2 参考资料
**官方文档**
- 文档名称: https://xxx
**开源实现**
- 项目名称: https://github.com/xxx
**社区讨论**
- 讨论来源: https://xxx
Word 文档格式化脚本，功能包括：
用法：
python .opencode/skills/deep-research/scripts/format_docx.py "输入.docx" ["输出.docx"]
用户输入：
调研下 Ralph Loop
执行流程：
# 1. 创建主题目录
mkdir -p "{output_dir}/Ralph-Loop/images"
# 2. 获取内容（如有 URL）
webfetch https://example.com/article
# 3. 深度调研（使用 Task 工具联网搜索）
# 4. 生成信息图
python .opencode/skills/image-service/scripts/text_to_image.py "技术架构图..." --output "{output_dir}/Ralph-Loop/images/architecture.png"
# 5. 撰写报告
# 写入 {output_dir}/Ralph-Loop/Ralph-Loop调研报告.md
# 6. 导出 Word（不使用 --toc，Markdown 已有手写目录）
cd "{output_dir}/Ralph-Loop"
pandoc "Ralph-Loop调研报告.md" -o "Ralph-Loop调研报告.docx" --resource-path=.
python ../../../.opencode/skills/deep-research/scripts/format_docx.py "Ralph-Loop调研报告.docx"
输出文件：
{output_dir}/Ralph-Loop/
├── images/
│ ├── architecture.png
│ └── comparison.png
├── Ralph-Loop调研报告.md
└── Ralph-Loop调研报告.docx