shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析无需 API Key

通用报告Skill

生成面向客户的分析型研究报告（单文件自包含 HTML，含封面、侧边目录、响应式、打印样式）。当用户要求「写报告/出分析报告/行业研究/对比报告/研究报告排版/统一报告样式与交互」，或需要规范报告的样式、排版、交互、版本管理与数据引用时使用。支持用户直接上传数据文件（Excel/CSV/JSON 等）由数据驱动生成报告。业务无关、语言无关，由占位符参数化，可套用内置 HTML 骨架与多套主题。

person作者: user_456c10b8hubcommunity
download下载资源包

Report Generator（通用分析报告生成器）

Overview

把任意「面向客户的分析型研究报告」固化为可复用工作流，产出真·自包含 HTML（ECharts/Mermaid 经 make_selfcontained.py 内联，断网可用）。仅保留跨业务通用的报告方法论（证据分级、结论先行、论证链、设计系统、交互规范、版本管理、数据驱动），不含行业/业务特定内容。

支持两种输入模式：研究型（AI 自行取证撰写，P2 走取证分支）/ 数据驱动型（用户上传 Excel/CSV/JSON/PDF/文本，由数据直接成稿，P2 走数据接入分支）。

1. 适用场景（When to use）

  • 需反复给客户出、且要求"像同一个人写的/客户能信/下次还能改"：行业研究·项目总结（月/季/半年/结项）·竞品对比·监测月报·策略建议。
  • 希望统一样式/排版/交互/版本管理/数据引用，或上传自有数据直接成 HTML。
  • 对比/盘点类，需稳定可视化+证据溯源呈现。

首次做？速查：先按 content-planning.md §0.5 做前置澄清/前问三思，再填启动输入模板（§3 P0）；高频疑问翻 faq-antipatterns.md。

2. 两种模式（快速 / 专业）

| | 快速模式（赶时间 / 内部汇报 / 草稿） | 专业模式（对外交付 / 客户报告） | |---|---|---| | 触发 | 用户直接给主题要报告，未提「按流程/严谨/对外」 | 用户要严谨流程，或对象为外部客户/监管/投资者 | | P0 澄清 | 一句话收四要素，缺省项由默认框架补齐 | 前问三思 + 启动输入模板逐项确认 | | P1 规划 | 轻量：故事线 + SCR + 章节骨架 | 完整 MBB：证据底表 + 故事线 + SCR + 逐页蓝图 | | 确认门 | C1 合并（确认即出稿，不再单独 C2） | C1 / C2 / C3 三道门逐道拍板 | | P5 核查 | 29 道质量门禁全跑 + self-check 只核 P0 | 29 道质量门禁全跑 + 35 条全核 |

两种模式都不可降级（铁则）：① §4 内容真实性（不编数字、模糊归因标 [待验证]）；② 29 道质量门禁（编号 1–29，Gate8 为保留扩展位）由 validate_report.py 全跑；③ self-check 的 P0 项任一不过 = 禁止交付。

可随时升级：快速模式出稿后若用户要求「再严谨些」，补跑专业模式的 P1 规划与 C2 确认即可，不必推翻重来。

3. Workflow（六步流水线 + 三道确认门）

最简路径（先跑通再深究）：写一份内容包，一条命令出报告—— python scripts/make_report.py --content 内容包.md --out 报告.html（可选 --pdf --docx --credential）。 该命令自动串起 D3体检→build→F 事实门禁→29 道质量门禁→离线内联；门禁 FAIL 即阻断交付。极简写法与内容包模板见 references/authoring-minimal.md。

  • C1：P1 内容规划确认（故事线 + SCR + 逐页蓝图 + 信息密度/组件清单）
  • C2：P3 逐页蓝图确认
  • C3：P5 交付前 self-check 全绿

命名约定（勿混用）：C1/C2/C3＝人工确认门（用户未拍板不得进下一阶段）；Gate1~Gate29＝脚本机械质检（validate_report.py）。二者无关。

| 阶段 | 一句话 | 入口文件 | |---|---|---| | P0 澄清 | 前问三思 → 启动输入模板收集四要素+风格+标识（D3 四要素问卷体检缺项 / D4 起步 prompt 库 / M 多模型能力档确认 model_adapter.py） | references/phase-p0.md | | P1 内容规划 | MBB：先规划不堆素材；SCR + 逐页蓝图 | references/phase-p1.md | | P2 取证/数据接入 | 证据五档定档 + 待验证清单 | references/phase-p2.md | | P3 大纲+设计 | --suggest-modules 推导模块集，套骨架排章节 | references/phase-p3.md | | P4 撰写+可视化 | 结论先行、每模块一观点、按蓝图落地 | references/phase-p4.md | | P5 质量核查+版本 | C3 全绿才交付；跑 29 道质量门禁、写学习记录 | references/phase-p5.md |

降 token（默认路径）：写内容包（~12KB）→ build_report.py 渲染 → make_selfcontained.py 内联，替代读 68KB 骨架手抄（省~70%）。仅手工控结构时才写 HTML。 硬阻断 Gate（FAIL 即禁交付）：Gate1/3/5/9/10/20；其余 Gate 为 WARN。

4. 内容真实性与可溯源（最高优先级）

  • 不编造；无法核实标 [待验证]/[未确认]/[UNSOURCED]；官方口径优先、第三方降档标注。
  • 证据五档：L1 官方 / L2 权威媒体·学术 / L3 第三方实测 / 待验证 / 用户提供(第一方)。
  • 来源类型→定档映射（采集即定档）见 references/phase-p2.md §证据定档映射。
  • 五类合格标注（任一即溯源）：①具名来源 ②脚注/尾注 ③括号引用(来源：XX,2025-06) ④口径/范围声明 ⑤公式推导。
  • 模糊归因黑名单（出现即标 [待验证]+补合格标注）：相关数据显示 业内通行 网传 知情人透露 某机构研究 权威人士指出 普遍认为 众所周知 不完全统计 多方消息。铁则：任一数据点须满足五类之一；裸数据/模糊归因一律不合格→升待验证清单。
  • 溯源闭环（data-src 锚点/Gate20）与来源表可点击外链（Gate25）细则见 references/phase-p2.md §证据定档映射。
  • 待验证占比 >30% → 执行摘要强制预警"证据基础偏弱，结论仅供参考"。
  • 事实断言溯源 + 系列一致性（F / F-ext / H）：写稿期 verify_claims.py -c 内容包.md 拦「无溯源断言」→ FAIL（禁止交付），--fill-plan 出补证清单回填复验至 PASS；series_guard.py 守护多期风格/明暗/章节/指标一致（init 基线 · check 漂移，hard=风格明暗变更）。细则见 claim-fill.md / series-reports.md。

5. 报告框架（开篇 → 主体 → 收尾）

5.1 框架总则

框架由四轴正交共定：主题→场景类型、对象→受众维度、时长→论证深度+模块范围，叠加 [汇报侧重]；任一轴未指定→默认框架。模块集判定见 §5.6（场景必选）+§5.6b（侧重升必选）+§5.7（论证链映射）。

**默认框架（项目总结汇报导向，P0 四要素缺省时启用）**的模块集/标准分析切片/可选模块/默认参数/切换条件见 references/framework-tables.md §5.1。

  • 客户疑问驱动：每模块先答"帮客户搞清楚什么"，不因为"通常有"就放。
  • 论证链溯源：每模块须溯到 §5.7 至少一个论点；无论点支撑=冗余，删。
  • 动线不逆 + 模块级结论先行（标题写可独立成立的结论句，非话题词）。

5.2–5.8 框架参考表（静态数据 · 按需懒加载）

§5.2–5.8 的模块目录/场景必选矩阵/侧重加权/论证链映射/四轴判定表全在 references/framework-tables.md，仅 P3 推导模块集时读取（省约 5K token/次）；Gate5 持有权威副本（SCENE_MANDATORY）。核心纪律：必选+论证链有支撑不可删、无孤儿模块、层级不跳、动线不逆；通用汇报 5 模块兜底。

6. 可视化与图表规范

  • 流程图/对比矩阵/热力图/节奏图须出图。引擎：交互多系列→ECharts；流程/时序/架构→Mermaid；离线简单图→内联 SVG。
  • 图表选型决策树：按「分析意图 × 数据形态」定图（地理/流向/矩阵/进度→专用图；时间轴→趋势；部分→整体→构成；分布/关系→统计；对比/排名→柱/条/散点），完整表见 references/chart-snippets.md §1.2。数据驱动可用 scripts/build_report.py::recommend_chart() 自动给图型（与决策树一致）。
  • 对比/排名必须含对标基准线（行业/竞品/历史）；数据驱动用真实数据，禁占位冒充。
  • 图表可访问性（铁则）：经骨架 window.rgRegister(dom, option) 注册的 ECharts 自动补 role="img"+aria-label（取自同卡片 .chart-title，无标题回退「图表（<类型>）」）；需精确数据摘要时手动覆盖 aria-label；原生 echarts.init/非骨架容器图须手写 role/aria-label。

7. 交互规范

侧栏 scrollspy + 移动端抽屉/悬浮 + 返回顶部；附录/术语/证据可折叠；图表 tooltip/legend/dataZoom/tab；表格列排序；打印 @media print 展开折叠、隐交互按钮、避章节内断行。

8. 设计系统与样式

静态细节（design tokens 清单 / 11 套风格枚举与关键词映射 / --chart-1..6 数据色板 / 排版细则）见 references/design-system.md §8，仅 P4 撰写+可视化时按需读取。

  • design tokens 统一引用：全篇主色/中性灰/状态色/数据色板/字体栈/圆角/间距均定义在骨架 :root 与 [data-theme][data-mode]，禁止硬编码散落。
  • 数据色/状态色严格分离（铁则）：图表只用 --chart-1..6；--ok/--warn/--bad 仅状态 pill；基准线用中性 --ref 灰蓝虚线。
  • 排版三原则：一致性（引 tokens 禁混字号）/整齐（统一对齐留白）/清晰（一模块一观点）；关键内容用 .hl 强调。正文 15–16px、行高 1.7、对比度≥4.5:1；封面不重复结论四卡；打印 break-inside:avoid+页眉页脚页码。

9. 客户视角与落地友好

红黄绿灯(指标×阈值×触发动作)；客户侧风险单列；移动端导航/返回顶部/打印入口齐备。

10. 数据驱动场景

  • 输入：[数据文件]+[研究主题/受众](+可选[数据处理要求])；接入核查解析结构/口径，缺失/异常/冲突文中标差异不隐去，标「用户提供·[文件]·[日期]」定用户提供档（官方直供可 L1），过大则摘要/抽样。
  • 图表优先真实数据驱动。
  • 禁止捏造指标（铁则）：只用文件直接包含的字段/数值；未给的统计量禁自行计算充当。
  • 派生指标三要素（确需新增时）：①明确公式 ②说明业务含义 ③标输入来源与等级；图中标 <span class="evd ev-p">用户提供·派生</span>。

11. 版本管理

  • 主.次.修订：主=结构级 / 次=内容增量(含数据更新) / 修订=排版措辞小修。
  • 保留上一版快照 + 版本记录（改动要点 + 定级理由）；交付前核查：锚点/编号/目录一致、无重复、标签配平、溯源/精简/排版过关。
  • 次版本以上迭代须附 scripts/report-diff.py 差异摘要（格式见 references/phase-p5.md §版本差异记录）。

12. 行文风格

事实与描述分离；去黑话；顺序自然（先"为什么是现在"再展开）；交付前对照 punctuation-rules.md 逐条核验（章号层级/标点/字形/表格/引用/AI 痕迹）。

13. 复用检查清单（self-check = 验收口径）

交付规则：全绿才交付；P0 任一条未过 = 禁止交付；P1 未过 ≥3 建议修正后交付（<3 可标「已知待改进」）；P2 不影响交付但记版本记录。完整 35 条见 references/self-check.md（P5 才读）。严重度：P0 交付阻断 / P1 重要 / P2 体验。

P0 速记（任一不过即禁交付）：证据底表+故事线+蓝图已产出；P1 前置反问已执行；C1 覆盖全清单；每条事实有出处与徽标；待验证>30%已预警；框架过 §5.5–5.7 无孤儿；四要素齐备；§5.6/§5.6b 必选落实；版本号与记录已更新；数据驱动已核查。

14. 占位符清单（参数化入口）

完整参数（行业模板/品牌色/语言/图表引擎/论证深度/report-style·report-mode meta/邮件摘要等）见 references/design-system.md §14，P0 启动模板按需读取；下表仅列最常用、须封面/meta 落地的核心项。

核心占位符（封面/meta 必落地）：[汇报主题] [汇报对象] [汇报时长] [场景类型] [汇报侧重] [汇报对象企业/标识] [视觉风格] [明暗模式] [数据文件(可选)]。

其余与 §3 启动输入模板一一对应（启动模板第 5/6 项即 [视觉风格]/[明暗模式]→骨架 report-style/report-mode meta；[行业模板]/[品牌色]/[语言]/[图表引擎]/[论证深度]/[邮件摘要]/[邮件报告链接] 等详见 design-system.md §14）。

15. Resources（分组速查 · 完整索引见 references/resource-index.md）

| 类型 | 入口 | |---|---| | 骨架/行业预设 | templates/html-skeleton.html（11 风格×明暗）、templates/industry-templates/*.json（8 预设） | | 阶段卡 P0–P5 | references/phase-p0.md~phase-p5.md、content-planning.md | | 框架/工具/图表 | framework-tables.md、frameworks.md、chart-snippets.md | | 验收/排版/一致 | self-check.md(35条)、punctuation-rules.md、doc-consistency-check.md | | 护城河脚本 | make_report.py(一键编排)、verify_claims.py(F/F-ext)、series_guard.py(H)、model_adapter.py(M)、build_report.py、validate_report.py(29 道质量门禁)、make_selfcontained.py | | 派生/交付 | make_pdf.py/make_docx.py、gen_qc_report.py、report-diff.py、learn_analyze.py、compliance-credential.md(合规凭证)、authoring-minimal.md(极简上手)、claim-fill.md/series-reports.md/models.md/faq-antipatterns.md/design-system.md/email-summary.md |

16. 持续自我优化（基于使用习惯的自适应迭代）

  • 何时写：每次 C3 交付后追加 LEARN_DIR/usage-log.md，样本 ≥3 份后触发自我审计。
  • 写哪里：LEARN_DIR/usage-log.md（只追加）→ scripts/learn_analyze.py → LEARN_DIR/learned-defaults.json。
  • 谁读：P0 启动模板读 learned-defaults.json 作软建议预填，用户可覆盖。

完整 schema/触发条件/护栏见 references/learn-loop.md；学习状态隔离在 ~/.workbuddy/skill-data/report-generator/（按用户隔离、不随包发布）。

17. 常见问题与反模式（FAQ · 懒加载）

完整 6 子节见 references/faq-antipatterns.md；遇到以下情形先翻该文件：

  • 17.1 风格/框架误用：引用已下线风格、混搭多套 token、P1 用于快讯、行业模板凌驾默认框架、AI 生成数字当证据
  • 17.2 字段键与封面坑：副标题空白/键错（report-* 前缀）、封面标题被占位污染、风格中途切换、外部对象缺企业标识
  • 17.3 Gate 体系与排查：哪几道是 FAIL（Gate1/3/5/9/10/20）、SHA-256 不匹配、Gate22 误报、资产不合规、颜色/WCAG
  • 17.4 图表/骨架报错：图表 ReferenceError/空白图、内联失败、<title> 不一致、无障碍缺失
  • 17.5 数据驱动与外部源：xlsx 损坏、CSV 逗号、未标"用户提供"、文件过大
  • 17.6 版本与升级：主/次/修订定级、learned-defaults、审计整改交接