前言¶

在 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 加载技能后应按同一规范执行。

1. 输入：必填参数 clean_data（array），为清洗后的标准结构化业务数据列表；文档写明可与 CleanData 技能输出的干净数据衔接。
2. 计算指标：
   - 统计周期内销售总额；
   - 计算单条记录的平均销售额（实现上对每条数据的第二列金额求和再除以条数）。
3. 输出：analysis_result（string），为标准化销售指标分析结论文本。
4. 合规约束（技能自述）：仅做统计计算；不做文件读写或数据修改；不发起外网请求；只输出聚合指标，不输出原始明细。

参考实现中，输入形如 [["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