前言¶
业务侧经常手里只有一张「指标—数值」表，却要交一份能直接打开、带图、带结论说明的材料。手写 HTML、接 Chart.js、再补几段分析文案，往往比算数还费时间。若希望 Agent 按固定结构产出单文件报告，而不是每次从零拼模板，可以装一个面向「数据报告撰写」的 Skill，把标题、数据、分析目标和版式约束写进同一套流程里。
这是什么¶
数据报告撰写（坐标 @user_2f63f22a/outputreport）是 SkillHub 上的社区 Skill，分类为 data-analysis，当前版本 1.0.0，由发布者 user_2f63f22a 维护。标签标明 requires_api_key=false，安装后不需要额外配置 API Key。
Skill 包内的 SKILL.md 以 DataReportSkill 类形式描述能力：根据传入的字典数据与分析目标，生成图文并茂的 HTML 数据报告（内嵌 Tailwind CSS 与 Chart.js 的 CDN 引用），并写入本地文件。官方页面与资料入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_2f63f22a/outputreport
- 官方地址（资料线索）：https://api.skillhub.cn/user_2f63f22a/outputreport
核心功能¶
以下能力均来自已安装的 Skill 包内 SKILL.md 实现说明，未超出该文件描述范围。
报告内容与结构¶
生成单页 HTML，大致包含三块：
- 数据可视化：根据
analyze_data绘制 Chart.js 图表。 - 深度数据分析：自动生成三段式文案（核心结论、数据洞察、优化建议）。
- 原始数据明细：以表格列出指标与数值。
页头展示报告标题、分析目标、作者与生成日期。
入参约定¶
初始化时需传入：
| 参数 | 含义 |
|---|---|
report_title |
报告标题 |
analyze_data |
分析数据，字典格式，支持一维键值 |
analyze_target |
分析目标，例如季度销售复盘、用户增长分析 |
report_style |
可选，默认「商务正式」 |
author |
可选，默认「数据分析师」 |
报告风格¶
内置三种风格模板（对应 Tailwind 类名组合）：
- 商务正式（默认）
- 简洁清爽
- 可视化聚焦
未识别的 report_style 会回退到「商务正式」。
图表类型选择¶
按数据结构做简单规则判断：
- 数值均在 0–100 且总和约等于 100 → 饼图（占比类）
- 键名含如
1月、Q1、周一、2024等 → 折线图（趋势类） - 其余 → 柱状图（分类对比）
输出方式¶
调用 generate_html_report(save_path) 将完整 HTML 写入指定路径，默认文件名为 data_report.html。
安装与启用¶
安装方式以 SkillHub 官方安装文档为准：https://skillhub.cn/install/skillhub.md
1、确认 CLI¶
command -v skillhub && skillhub --version
未安装时可按官方脚本安装 CLI（完整安装或仅 CLI，见该文档第一节）。
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install outputreport --namespace user_2f63f22a --dir <skills 目录>
SkillHub 检索结果中的等价写法为：skillhub install outputreport --namespace user_2f63f22a。
3、各客户端 skills 目录（摘自官方安装文档）¶
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
装到对应目录后，按你所用客户端的 Skill 加载方式启用（官方安装文档提示：目录不对或未重启时 Agent 可能读不到新 Skill）。Codex CLI、Claude Code 与 Cursor 在安装命令上一致，差异主要在 --dir 路径。
典型用法¶
SKILL.md 中的参考实现为 Python 类。在本地按同一契约调用时，流程是先构造实例，再生成 HTML 文件。
from pathlib import Path
# 实际项目中需保证 SKILL.md 中的 DataReportSkill 可被导入，或按 Agent 指引内联同等逻辑
skill = DataReportSkill(
report_title="2026 年 Q3 区域销售复盘",
analyze_data={"华东": 320, "华南": 280, "华北": 190},
analyze_target="季度销售复盘",
report_style="简洁清爽",
author="数据分析组",
)
skill.generate_html_report("q3_sales_report.html")
在 Cursor 等 Agent 环境中，更常见的用法是：安装 Skill 后，用自然语言说明标题、字典数据、分析目标与风格，让 Agent 按 SKILL.md 的结构生成 HTML 并保存到指定路径。具体对话示例因客户端而异，此处不编造未在官方资料出现的提示词模板。
打开生成的 HTML 时，页面会从 CDN 加载 Tailwind 与 Chart.js，需能访问对应外链。
适用场景与注意¶
适合：
- 已有结构化字典数据（一维指标表），需要快速得到可分享的 HTML 报告。
- 希望图表类型、版式和分析段落结构相对固定，减少每次手写前端样板。
- 不想为报告生成单独申请第三方 API Key（本 Skill 标记为无需 API Key）。
限制与注意：
analyze_data在参考实现中按「单组键值」处理；复杂多维表、多系列对比需自行扩展或让 Agent 在生成前聚合数据。- 分析文案由最大值、最小值、总和等规则模板生成，深度业务解读仍依赖你补充上下文或人工修订。
- 图表类型判断依赖简单启发式，键名或数值形态特殊时可能选错图种，生成后宜目视检查。
- 报告依赖 CDN，离线或内网环境打开 HTML 时样式与图表可能无法加载。
- SkillHub 页面展示的统计（截至资料抓取）：评分 100000，下载 3231；社区来源，使用前可在 SkillHub 页核对版本与更新。
结尾¶
数据报告撰写把「标题 + 字典数据 + 分析目标 + 可选风格」收敛成单文件 HTML 报告流程，适合需要快速交付可视化说明、又不想每次从零搭 Chart.js 与版式的场景。安装与目录配置以 SkillHub 官方文档为准，技能详情与坐标见：https://www.skillhub.cn/skills/user_2f63f22a/outputreport
