1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | sales-reporting-hubspot-agent-cli-skills | — |
| 项目自述名称 | HubSpot Agent CLI Skills（合集仓库自身名） | GitHub README |
| 作者/维护者 | HubSpot（CRM/营销 SaaS 厂商），官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/HubSpot/agent-cli-skills/tree/main/sales-reporting | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars | 13（合集仓库整体，含 15 个子技能，不代表本技能个体热度） | GitHub API |
| Forks | 6 | GitHub API |
| 最新版本 | 无正式版本标签，持续滚动提交 | GitHub API |
| 安装方式 | npx skills hubspot/agent-cli-skills/sales-reporting（单装）或 npx skills hubspot/agent-cli-skills（全装 15 个技能） |
官方 README |
2. 功能介绍与亮点
sales-reporting 是 HubSpot 官方 agent-cli-skills 仓库中的报表技能，教编程 Agent 直接用官方 hubspot 命令行工具从 CRM 数据生成销售管理常用的三类输出：
- 每日简报：未来 7 天内到期的交易、逾期未跟进的交易，一条命令拉取；
- 管道快照：按阶段、按负责人聚合当前在途交易数量与金额；
- 赢单/输单分析：按时间窗口统计赢率、按负责人拆分成交金额，并支持按月汇总营收趋势。
技能全程只读，不对 CRM 数据做任何写入，且对 HubSpot API 的几个实际陷阱做了明确提示：分页上限 100 条时如何判断结果被截断、hs_is_closed_won 等布尔字段在 API 返回中实为字符串需要特殊比较、hubspot pipelines stages 不暴露阶段概率需改用 hs_is_closed_won 判断赢单等。这类细节通常要实际踩坑才会知道，写进技能文档里能让 Agent 一次就用对。
3. 适用场景
所属分类：集成与工作流自动化
已经把 HubSpot 作为 CRM 中枢的销售团队与销售运营（RevOps）人员，想在终端里直接问“这周有哪些交易要到期”“按负责人拆分本季度赢率”“上个月哪个月份营收最高”，不必打开 HubSpot 报表界面手动筛选，也不必自己写脚本处理分页与字段类型陷阱。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——HubSpot 官方帮助中心文档《Use the HubSpot Agent CLI》明确将 Claude Code 列为受支持 Agent，安装进项目
.claude/skills/目录 - Codex：✅ 原生支持——同一官方文档明确列出 OpenAI Codex 为受支持 Agent
- OpenClaw：❓ 未验证——已抓取材料未点名提及
- Hermes Agent：❓ 未验证——已抓取材料未点名提及
（官方文档另提及 Claude Cowork、Cursor、Windsurf 等其他编程 Agent 兼容，但不在本报告评估范围内）
5. 推荐理由
HubSpot 官方亲自维护的销售报表技能，把“今天该盯哪些交易、这个月赢率多少、营收趋势怎么走”这类销售管理者每天都要问的问题变成一条终端命令，且全程只读、零数据写入风险，是把编程 Agent 接入日常销售汇报最省心的官方路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | HubSpot 为纽交所上市 SaaS 公司官方出品；仓库本身星标不高，但已有外部用户在 issue 中描述将该技能包安装进含 50+ 技能的真实工作区并提出改进建议，属实际采用的具体证据 |
| 可用性 | 8 | 文档含完整命令示例，并明确记录了 API 分页截断、布尔字段字符串化等实操陷阱，减少 Agent 试错；需先配置 HubSpot 账号访问令牌；技能自身自初次收录后未见后续专属提交 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① Shell 命令及权限范围——通过官方 hubspot CLI 与本地 jq 执行，仅做只读查询（search/list/pipelines/owners），未见任何写入或删除指令
② 联网外发——仅连接用户自己 HubSpot 账号的官方 API，目标透明
③ API Key——需设置环境变量 HUBSPOT_ACCESS_TOKEN（私有应用令牌）或走浏览器 OAuth 登录，为标准做法
④ 可疑指令——已读取的 SKILL.md 全文内容清晰、逻辑单一，未见隐藏指令或混淆代码
⑤ 作者信誉——HubSpot 官方组织仓库，提交者为可查的公司员工账号
⑥ License——Apache License 2.0，清晰
⑦ 维护时间——技能内容随仓库一次性收录，仓库整体近日仍有其他技能的提交，非弃置状态
额外亮点：全程只读、不触碰任何写入或删除接口，风险面低于同仓库内涉及批量写入的姊妹技能
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异化说明 |
|---|---|---|
| claude-office-skills/skills 的 crm-automation | 面向 HubSpot、Salesforce、Pipedrive 三家 CRM 的通用自动化技能，基于 n8n 工作流模板 | 覆盖面更广（多 CRM + 线索捕获/评分/多系统同步等写操作），但对单一 CRM 的字段类型陷阱、分页截断等实操细节没有 sales-reporting 这样的深度记录，且以写操作为主 |
| forcedotcom/sf-skills（Salesforce 官方技能集） | Salesforce 官方维护的 Agent 技能集合，面向“在 Salesforce 平台上构建应用”（Apex、Flow、LWC 等开发任务） | 定位是给开发者写 Salesforce 代码用的，不是给销售/运营人员直接查询报表用的；与 sales-reporting“终端直接问业务问题”的定位不重合 |
| 直接调用 HubSpot REST API（无 Skill 封装） | 开发者自行查阅官方 API 文档、手写分页与字段处理逻辑 | 没有内置的分页截断提示、布尔字段字符串化等踩坑记录，每个新会话都要重新摸索这些细节 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；仓库自身 issue 区有外部用户（账号注册于 2017 年、36 个公开仓库）描述了将该技能包安装进已有 50+ 技能的工作区后遇到的命名可辨识度问题（crm-lookup、quote-to-cash 等通用名称难以辨认所属技能包），并提交了改进方案（本地加 hubspot- 前缀重命名并提交上游 PR）。
9. 其他补充
同一仓库下另有 14 个姊妹技能（如 bulk-operations、workflow-automation、deal-management、ticket-resolution 等），覆盖数据批量操作、工作流管理、销售执行、客服工单等场景，sales-reporting 是其中专注“数据洞察与汇报”的一支。
10. 安装使用方式
# 只安装 sales-reporting 一个技能
npx skills hubspot/agent-cli-skills/sales-reporting
# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills安装后注意事项：需先安装并登录官方 hubspot CLI，设置 HUBSPOT_ACCESS_TOKEN（私有应用令牌）或完成浏览器 OAuth 登录；无需重启 Agent，安装完成即可在对话中触发。
11. 注意事项
- 需要一个 HubSpot 账号（含免费版）才能实际使用
- 该 CLI 与 HubSpot 开发者工具
@hubspot/cli（hs命令）是两个不同工具，不要混淆 - 报表口径受限于 HubSpot 数据模型本身——例如管道阶段不暴露“赢单概率”字段，只能用是否赢单的布尔状态间接判断
- Codex 已获官方文档确认支持；OpenClaw / Hermes Agent 的兼容性未经验证，官方文档未点名