report-helper

SKILL.md

---
name: report-helper
description: |
  当用户说「深度研究 X」「深入研究 X」或要求生成某产品、公司、概念、人物、产业链、政策、趋势的深度研究/发展研究报告时触发，自动进行联网搜索和研究，产出排版后的 PDF 文档，总字数通常 1-3 万字。
license: MIT
metadata:
  version: "1.0.0"
  openclaw:
    skillKey: report-helper
    homepage: https://github.com/Jiaranbb/report-helper
    requires:
      anyBins: ["python3"]
    apiKeySource: none
---

# Report Helper

## ClawHub 版本说明

这是面向 ClawHub 发布的 `report-helper` 版本。它保留完整深度研究报告流程和 PDF 渲染脚本，但包体只包含运行所需文件：

- `SKILL.md`
- `references/`
- `scripts/`
- `config.example.json`
- `LICENSE`

安全边界：

- 脚本只处理本地 Markdown、HTML、PDF、配置和日志文件。
- 脚本不会读取浏览器凭据、账号密钥、系统密钥或其他敏感凭据。
- 脚本不会联网下载、安装依赖或执行远程代码。
- 默认输出只写入 `./output/`；用户可通过本地配置或环境变量改路径。
- 如果依赖缺失，只报告缺失项并请用户决定如何处理；不要在未获确认时安装依赖。

## 触发提示

触发：用户明确说 `深度研究`、`深入研究`、`深度分析报告`、`发展研究报告`、`产业研究报告`，对象可以是产品、公司、概念、人物、产业链、政策或趋势。

不触发：简单名词解释、普通概述、一般「分析一下」、不需要长报告和 PDF 的问答。

拿到触发请求后，先在 chat 里输出范围对齐简报：

```markdown
【关卡一 · 研究范围对齐】
研究对象：{具体名称，模糊的先收敛}
类型：产品 / 公司 / 概念 / 人物 / 产业链 / 政策 / 趋势
研究动机：{为什么研究，最近发生了什么}
特别关注：{用户希望深入的方向；没有就写「无特别指定」}
成品体裁：{按用户原话判断，如「正式发展研究报告」「产业研究报告」「叙事型深度研究」}
交付格式：PDF
报告署名：{读取 config.local.json 的 author；如果为空，必须请用户填写}

执行模式（请选）：
- 【交互模式】默认。关卡二、三会停下等你审核后再继续
- 【auto 模式】一路跑到底，中间不等你。关卡二、三的自评简报还是会输出，但不等确认

以上理解是否正确？选哪种模式？
```

用户确认前不要进入搜集。用户说「自动进行」「一路跑」可理解为 auto 模式，但仍需完成关卡一复述并拿到确认。

## 模式分流

- **交互模式**：关卡一、二、三都要停住等用户确认。
- **auto 模式**：关卡二、三照样输出简报，但不等确认；信息严重不足必须补搜，原创性/体裁自评失败必须回炉。
- 任何模式下都不能编造缺失事实。搜不到的信息写入「未搜到 / 存疑」。

## 工作流

1. **搜集资料**：读取 `references/workflow.md` 和 `references/subagent-research-prompt.md`。按三路 research worker 分工搜集，并把中间资料落盘到配置的 `intermediate_dir`（默认 `./output/intermediate/{topic-slug}-{YYYY-MM-DD}/`）。
2. **信息充分性审计**：按 `references/workflow.md` 输出关卡二审计。交互模式等待用户；auto 模式按建议继续，严重缺口必须补搜。
3. **形成判断**：按 `references/workflow.md` 做写作准备审计，确认核心判断、证据链和体裁路由足以进入写作。
4. **选择体裁并写正文**：读取 `references/report-template.md`、`references/writing-style.md` 和 `references/source-citation-rules.md`。对象是产品、公司、概念或人物时，再读取 `references/adaptations-by-type.md`；对象是公司时，正文必须包含成长性和估值相关的定量分析。
5. **审核**：读取 `references/review-checklist.md`，命中即改，直到通过。
6. **生成交付物**：读取 `references/delivery.md`；保存内部 Markdown 构建稿，按需追加 log，生成 PDF。
7. **经验沉淀**：遇到 PDF、事实核查、log、未来预测、报告结构或 skill 维护问题时读取 `references/gotchas.md`；本次发现新坑，或用户指出流程/事实/结构问题时，先补充 gotchas，再继续交付。

## 配置与隐私

- 共享配置模板是 `config.example.json`；本地私有配置写入 `config.local.json`，不要提交。
- 首次安装时必须让用户填写报告署名 `author`；不要默认使用工具作者名。
- 首次使用或环境不明确时，先运行 `python3 scripts/check_environment.py`；不通过时先向用户说明缺失项，再由用户决定是否补配置或处理依赖。
- 脚本读取顺序：内置默认值 → `config.local.json`（或 `REPORT_HELPER_CONFIG` 指向的 JSON）→ `REPORT_HELPER_*` 环境变量。
- 报告署名在首次配置时自定义昵称；本地绝对路径、私有日志标题、账号标识等个人配置只放在 `config.local.json` 或环境变量里。

## 输出规则

- 正文结构以 `references/report-template.md` 为准，不在 `SKILL.md` 里展开目录。
- 用户要「发展研究报告 / 产业研究报告 / 政策研究 / 趋势报告 / 2026-2030 报告」时，使用 `report-template.md` 的 **A. 正式研究报告结构**。
- 用户要产品、公司、人物、概念深度研究且未指定正式体裁时，使用 `report-template.md` 的 **B. 叙事型深度研究结构**。
- 用户明确指定目录或栏目时，用户指定优先；仍需保留必要的信息来源章节。
- 进入正文写作前必须完成最新数据校验；如果研究对象有近 12-24 个月数据更新，必须优先查到最新官方/监管/财报/原始披露或权威报道后再写。
- 公司研究不能只写叙事深度；必须加入成长性、盈利质量、现金流/融资、估值或可比公司等定量分析。非上市公司缺少公开估值或收入数据时，要写明缺口和替代观察指标。
- 正文关键事实判断必须使用 `<sup>a1</sup>` 这类上标标注来源等级和编号；正文前声明编号规则，末尾用「信息来源与分级」按 a/b/c/d 分组列出完整来源，没有 c 和 d 就不写对应小节。
- 默认输出到 `./output/`；可用 `config.local.json` 或 `REPORT_HELPER_*` 环境变量改路径。
- PDF 文件名建议为 `{研究对象}深度研究报告.pdf`，封面标题使用正文 H1。
- 内部 Markdown 构建稿只作为 PDF 渲染输入；如果配置了 log 目录，交付时追加记录。
- PDF 的报告署名来自 `author` 配置；不要把工具作者名当成默认报告署名。
- PDF 最末尾必须追加工具签名：`本报告由 report-helper skill 工具协助生成`、`开源地址：https://github.com/Jiaranbb/report-helper`、`交流和建议可联系作者：嘉然 Jiaran（+v: evadebot）`。
- 交付前验证：中间资料可追溯；PDF 页数和首页排版正常；PDF 文件存在且大小不为 0。
- 常用脚本：`scripts/check_environment.py`、`scripts/append_report_log.py`、`scripts/md_to_pdf.py`、`scripts/render_pdf_with_fallback.py`。具体用法见 `references/delivery.md`。