前言¶
業務側經常手裏只有一張「指標—數值」表，卻要交一份能直接打開、帶圖、帶結論說明的材料。手寫 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
