前言¶
在 Agent 裏做業務數據分析時，常見做法是每次手寫「算總額、算均值、按口徑寫結論」的提示詞，口徑容易漂移，也難和企業內部的清洗流程對齊。若上游已有標準化乾淨數據，更希望 Agent 按固定規範只輸出聚合指標，而不是反覆展開明細。
下面介紹 SkillHub 社區技能「分析數據」（@user_5f8aef2c/analyzedata，v1.0.0），它用通用 SKILL.md 約束 Agent：接收清洗後的結構化業務數據，計算銷售總額與平均銷售額，並輸出可展示的分析結論。
這是什麼¶
「分析數據」是 SkillHub 上分類爲 data-analysis 的社區來源（source: community）技能，發佈者爲 user_5f8aef2c。子分類包含數據可視化、數據洞察；標籤標明 requires_api_key=false，安裝後無需額外 API Key。
技能包內說明其定位爲企業內部銷售數據統計分析：面向清洗後的標準化業務數據，做聚合計算，用於內部經營復盤與數據自查；強調不對外輸出原始明細，以符合企業數據安全與統一口徑要求。SkillHub 頁面 v1.0.0 版本 changelog 與包內 SKILL.md 描述一致。
核心功能¶
以下能力均來自技能包 SKILL.md 與 main.py 的公開內容，Agent 加載技能後應按同一規範執行。
- 輸入：必填參數
clean_data（array），爲清洗後的標準結構化業務數據列表；文檔寫明可與 CleanData 技能輸出的乾淨數據銜接。 - 計算指標：
- 統計週期內銷售總額；
- 計算單條記錄的平均銷售額（實現上對每條數據的第二列金額求和再除以條數）。 - 輸出：
analysis_result（string），爲標準化銷售指標分析結論文本。 - 合規約束（技能自述）：僅做統計計算；不做文件讀寫或數據修改；不發起外網請求；只輸出聚合指標，不輸出原始明細。
參考實現中，輸入形如 [["2025-01", 1000], ["2025-02", 2000]] 時，會彙總第二列金額並給出總額與均值結論。
安裝與啓用¶
官方頁面提供兩種路徑：讓 AI 按安裝文檔操作，或使用 SkillHub CLI / Zip 包。
方式一：提示詞安裝（官方推薦文案）¶
將下列意圖發給支持 Skill 的 Agent（與 SkillHub 頁面「複製 prompt」一致）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_5f8aef2c/analyzedata。
Agent 會按 SkillHub 安裝與優先源配置 檢查或安裝 skillhub CLI，並把技能裝到當前環境的 skills 目錄。
方式二：CLI 安裝¶
先確認 CLI 是否可用：
command -v skillhub && skillhub --version
未安裝時可執行官方完整安裝腳本：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能時需用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能無法被識別。常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令示例（將 <skills 目錄> 替換爲實際路徑）：
skillhub install user_5f8aef2c/analyzedata --dir <skills 目錄>
方式三：Zip 包¶
SkillHub 提供 v1.0.0 壓縮包下載地址：
https://api.skillhub.cn/api/v1/download?slug=@user_5f8aef2c/analyzedata
解壓後將技能目錄放入上述 Agent skills 路徑，並重啓或刷新 Agent 的技能列表。
典型用法¶
技能文檔給出的輸入示例爲二維列表，每行第一項爲週期標識，第二項爲銷售額數值：
[["2025-01", 1000], ["2025-02", 2000]]
在對話中可以明確要求 Agent 啓用「分析數據」技能，並傳入已清洗的 clean_data。期望得到的是文字形式的 analysis_result，包含總銷售額與平均銷售額，而不是逐條明細表。
若工作流中已有數據清洗步驟，可先完成清洗再調用本技能，避免在分析階段重複處理髒數據。包內 main.py 僅作參考實現，實際以 Agent 讀取 SKILL.md 後的執行爲準。
適用場景與注意¶
適合誰
- 需要在 Agent 內做輕量銷售指標彙總、內部復盤摘要的團隊；
- 已與「清洗數據」類流程對齊，能提供結構化
clean_data的場景； - 希望分析口徑固定、輸出僅爲聚合結論的使用方。
限制與注意
- 技能自述僅限企業內部場景，數據與結果不得對外泄露或商用；部署前需結合本單位合規要求評估。
- 官方
overviewMd、摘要字段在 SkillHub 頁面爲空，詳細說明以技能包SKILL.md爲準；安裝前可在 SkillHub 查看安全掃描狀態（頁面展示爲 benign）。 - 當前公開版本爲 1.0.0；SkillHub 統計顯示下載約 11144 次（以頁面實時數據爲準）。指標計算邏輯較簡單，複雜多維分析需另配技能或擴展實現。
- 非空
clean_data才符合參考實現假設；空列表會導致參考實現中除零，生產環境應在上游校驗數據條數。
結尾¶
「分析數據」把銷售總額、平均銷售額等聚合計算寫進 Skill 規範，便於在 Agent 裏複用同一套內部分析口徑，並與清洗後的標準輸入銜接。無需 API Key，可通過 SkillHub CLI、官方安裝文檔或 Zip 包接入。
官方頁面：https://www.skillhub.cn/skills/user_5f8aef2c/analyzedata
API 座標：https://api.skillhub.cn/user_5f8aef2c/analyzedata
