A skill that guides an agent through deep research on a product, company, person, concept, industry chain, policy or trend. It gathers sources, checks them, synthesizes evidence and outputs a formatted PDF report of long length.
Claude Code
$ npx -y skills add Jiaranbb/report-helper --agent claude-code
Codex
$ npx skills add Jiaranbb/report-helper -a codex
Cursor
$ npx skills add Jiaranbb/report-helper -a cursor
Gemini CLI
$ npx skills add Jiaranbb/report-helper -a gemini-cli
GitHub Copilot
$ npx skills add Jiaranbb/report-helper -a github-copilot
OpenCode
$ npx skills add Jiaranbb/report-helper -a opencode
Windsurf
$ npx skills add Jiaranbb/report-helper -a windsurf
English README · 30 秒开始 · 示例报告 · 问题反馈 · 联系作者
作者 / 联系方式：嘉然 Jiaran · 公众号：嘉然学习笔记 · 微信：evadebot · X：@_jiaran
report-helper 是一个面向深度研究报告写作的 AI Skill。给出研究对象后，它会引导 agent 自动完成资料搜集、来源核查、证据整理、判断形成、审稿和 PDF 生成。
从一句话到一份可分享的正式 PDF：有来源、有判断、有排版。
它适合研究产品、公司、人物、概念、产业链、政策或趋势。目标不是生成几段概述，而是尽量跑完一套接近研究写作的流程，产出一份可核查、可阅读、可交付的长篇报告。
把下面这段话直接发给 Codex、Claude Code、OpenClaw 或其他支持 Skill 的 agent：
请从 GitHub 安装 report-helper skill：https://github.com/Jiaranbb/report-helper。安装完成后提醒我按当前工具要求重启或刷新 agent；重启后帮我运行 python3 scripts/check_environment.py 检查环境。
如果你的环境支持 skills CLI，也可以尝试：
npx skills add https://github.com/Jiaranbb/report-helper --skill report-helper
Codex 用户也可以手动安装：
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
--repo Jiaranbb/report-helper \
--path . \
--name report-helper
安装完成后，按当前工具要求重启或刷新 agent，让新 skill 生效。
<sup>a1</sup> 这类编号，文末按来源等级列出出处。示例由 Codex GPT-5.5 标准速度生成，耗时约 15 分钟。报告质量和所需时间依赖于模型能力、资料可得性、联网检索质量和研究对象复杂度。
运行示例：
PDF 预览：
示例报告：中国算力产业链深度分析报告.pdf
安装后，对 agent 说：
深度研究中国算力产业链，重点看 2026-2030 年的发展趋势，自动进行。
也可以这样描述：
深度研究某家公司，重点看商业模式、增长空间、估值逻辑和风险。
写一份 AI 算力产业发展研究报告。
深入研究某个产品的发展历程、竞争格局和未来演进。
默认情况下，report-helper 会先让你确认研究范围和执行模式。你可以选择交互模式，分阶段审核研究范围、资料充分性和写作准备；也可以选择 auto 模式，让它在中间自检后一路完成。
✅ 适合
❌ 不适合
| 任务 | 推荐说法 |
|---|---|
| 产业链研究 | 深度研究中国算力产业链，重点看 2026-2030 年发展趋势，自动进行。 |
| 公司研究 | 深度研究某公司，重点看商业模式、增长空间、盈利质量、估值逻辑和风险。 |
| 产品研究 | 深入研究某产品的发展历程、核心能力、用户场景和竞争格局。 |
| 政策研究 | 写一份某政策的深度研究报告，重点看影响路径、受益主体和潜在风险。 |
| 趋势研究 | 生成一份 2026-2030 趋势研究报告，要求有来源、有判断、有观察指标。 |
| 人物研究 | 深度研究某人物，重点看关键经历、决策风格、影响力和争议。 |
| 平台 | 状态 | 说明 |
|---|---|---|
| Codex | 支持 | 推荐环境；支持安装、检查环境、运行脚本和生成 PDF |
| Claude Code | 支持 | 适合长流程研究、资料搜集和写作迭代 |
| OpenClaw | 可用 | 需要能读取 skill 文件并执行必要 shell 命令 |
| Cursor / 其他本地 agent | 可用 | 需要能读写文件、联网检索并执行 Python 或浏览器渲染 |
| 普通 Chatbot | 不推荐 | 没有文件系统和渲染管线时，难以稳定生成 PDF |
第一次使用前，建议先完成三件事。
python3 scripts/check_environment.py
它会检查 Python 版本、config.local.json、报告署名、PDF 渲染依赖，以及 Chrome fallback 是否可用。不通过时，按脚本输出补配置或安装依赖。
如果环境检查提示缺依赖，安装：
python3 -m pip install markdown weasyprint
如果 WeasyPrint 在你的系统上安装或渲染失败，可以安装 Chrome，并在配置里填写 chrome_path，使用 Chrome 生成 PDF。
复制 config.example.json 为 config.local.json，然后按自己的需要修改：
{
"output_dir": "./output",
"work_dir": "./output/work",
"intermediate_dir": "./output/intermediate",
"author": "你的名字或组织名"
}
output_dir：最终 PDF 存放目录work_dir：内部构建稿目录intermediate_dir：中间研究资料目录author：报告署名，会显示在 PDF 封面；首次安装时由你填写{研究对象}深度研究报告.pdfPDF 最末尾会追加工具签名：
本报告由 report-helper skill 工具协助生成
开源地址：https://github.com/Jiaranbb/report-helper
交流和建议可联系作者：嘉然 Jiaran（+v: evadebot）
report-helper 会按 7 步执行：
正文关键事实判断必须使用上标标注来源等级和编号，例如：
<sup>a1</sup>：A 级，官方/学术一手来源<sup>b4</sup>：B 级，权威媒体原创报道文末按等级列出「信息来源与分级」：
a：官方/学术一手，政府机构、监管机构、公司年报和原始研究报告b：权威媒体原创报道c：行业媒体/工具商博客d：软文/服务商自述/不可验证默认不使用 c、d 级来源支撑正文判断。
report-helper/
├── SKILL.md ← Skill 入口和核心流程
├── README.md ← 中文项目介绍
├── README.en.md ← English README
├── SUPPORT.md ← 联系方式和支持入口
├── CHANGELOG.md ← 更新记录
├── LICENSE ← MIT License
├── config.example.json ← 本地配置模板
├── examples/
│ ├── report-helper-demo.png
│ ├── report-helper-pdf-preview.png
│ └── 中国算力产业链深度分析报告.pdf
├── references/
│ ├── workflow.md ← 研究和审计流程
│ ├── report-template.md ← 报告结构模板
│ ├── source-citation-rules.md ← 来源分级和编号规则
│ ├── writing-style.md ← 写作风格
│ ├── adaptations-by-type.md ← 不同对象类型的适配
│ ├── review-checklist.md ← 审核清单
│ ├── delivery.md ← PDF 生成和交付
│ ├── subagent-research-prompt.md ← 研究 worker 提示
│ └── gotchas.md ← 踩坑记录
└── scripts/
├── report_helper_config.py
├── check_environment.py
├── render_pdf_with_fallback.py
├── md_to_pdf.py
└── append_report_log.py
为什么一定要先确认研究范围？
深度报告最容易失败在「题目过宽」或「对象不清」。先对齐范围，可以减少后面资料搜集和写作方向的偏差。
为什么要强调最新数据？
产业、公司、政策和技术趋势变化很快。进入写作前必须完成最新数据校验，避免 agent 用旧资料直接写出过时结论。
可以只要 Markdown 吗？
公开版默认交付 PDF。内部 Markdown 构建稿主要用于渲染，不作为正式交付物。
公司研究为什么要加定量分析？
只写叙事容易变成故事。公司研究默认要求加入成长性、盈利质量、现金流、融资、估值或可比公司等内容；公开数据不足时，要写明缺口和替代观察指标。
PDF 乱码怎么办？
先运行 python3 scripts/check_environment.py 检查依赖。WeasyPrint 不稳定时，可以配置 Chrome fallback。
如何更新到最新版本？
重新安装，或在本地 skill 目录执行 git pull。
更多原创项目见 Jiaranbb 的 GitHub 主页。
嘉然 Jiaran（Jiaranbb） — 独立开发者／AI Builder
持续把自己真正需要的工作流做成可复用的 AI 工具与 Skills。
evadebotMIT License。详见 LICENSE。
Stars on GitHub
Fetches up-to-date documentation and code examples for libraries, frameworks, SDKs, CLI tools and cloud services, so an AI agent can answer API questions and generate code against current references.
@upstashGives Claude Code skills and agents for writing React documentation on react.dev, covering MDX components, voice and style rules, blog post structure, and interactive Sandpack code examples.
@reactjsAn agent skill that turns complex terminal output into styled HTML pages you actually want to read. Ask your agent to explain a system architecture, review a diff, or compare requirements against a plan.
@nicobailonA WYSIWYG markdown editor so you can edit markdown files like a Google Doc or Notion page, with a desktop app and web UI for navigation, search, and wiki-style linking. It also ships skills for working in codebase wiki, personal CRM, and knowledge base projects.
@inkeepA skill that guides an agent through deep research on a product, company, person, concept, industry chain, policy or trend. It gathers sources, checks them, synthesizes evidence and outputs a formatted PDF report of long length. Install it with the command on its page. It includes report-helper. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it