1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | quote-to-cash-hubspot-agent-cli-skills | — |
| 项目自述名称 | HubSpot Agent CLI Skills(合集仓库自身名) | GitHub README |
| 作者/维护者 | HubSpot(CRM/营销 SaaS 厂商),官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/hubspot/agent-cli-skills/tree/main/quote-to-cash | — |
| 许可证 | Apache License 2.0 | GitHub README |
| GitHub Stars | 13(合集仓库整体,含 15 个子技能,不代表本技能个体热度) | GitHub API |
| Forks | 6 | GitHub API |
| 最新版本 | 无正式版本标签,持续滚动提交 | GitHub API |
| 安装方式 | npx skills hubspot/agent-cli-skills/quote-to-cash(单装)或 npx skills hubspot/agent-cli-skills(全装 15 个技能) |
官方 README |
2. 功能介绍与亮点
quote-to-cash 教编程 Agent 通过官方 hubspot CLI 打通“产品目录 → 报价单 → 发票 → 订阅”的记录管理链路:
- 产品目录:创建产品记录,支持一次性与循环计费(
recurringbillingfrequency) - 报价组装:三步管道完成“创建行项目 → 创建报价单 → 关联”,并给出折扣字段(
discount为可写百分比,hs_total_discount为系统只读计算值)的正确用法 - 发票与订阅track:按状态、到期日筛选逾期发票、活跃订阅,汇总 MRR 等指标
- 继承同仓库的批量安全范式:依赖基础技能
bulk-operations的 JSONL 管道、分页与破坏性操作 dry-run/digest/confirm 二次确认流程,并接入hubspot history审计日志
SKILL.md 明确标注能力边界:报价审批路由、分享链接、PDF 生成与从零创建发票目前仍需在 HubSpot 网页界面完成,CLI 负责记录读写与状态流转。
3. 适用场景
所属分类:集成与工作流自动化
已使用 HubSpot CRM 的销售运营/财务对账人员,想让编程 Agent 批量建产品目录、组装报价单、核对逾期发票与订阅收入状态,省去手工在网页端逐条录入或自行拼接 HubSpot REST API 分页与鉴权逻辑。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 明确列出,默认安装到项目
.claude/skills/目录 - Codex:❓ 未验证——已抓取材料未点名提及
- OpenClaw:❓ 未验证——已抓取材料未点名提及
- Hermes Agent:❓ 未验证——已抓取材料未点名提及
(README 另提及 Cursor、Windsurf 等其他编程 Agent 兼容,但不在本报告评估范围内)
5. 推荐理由
HubSpot 官方维护,把“报价到收款”这条容易在 CLI 里踩坑的业务链路(只读字段误写、枚举值硬编码、跨对象关联方向)直接教给 Agent,同时继承同仓库经过验证的批量安全操作范式,让已用 HubSpot 的团队少走弯路。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | HubSpot 为官方出品;仓库 issue 区有外部用户在其含 50+ 技能的真实工作区中明确点名安装并使用了 quote-to-cash(连同其他两个技能),属实际采用的具体证据 |
| 可用性 | 7 | 文档含完整命令示例与字段说明,六字段速查表降低上手门槛;但报价审批、分享链接、PDF 生成与发票创建等环节仍需切回网页界面完成,且 invoices/subscriptions 需要令牌具备对应读取 scope,比同仓库纯 CRUD 类技能多一层限制 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:
① Shell 命令及权限范围——通过官方 hubspot CLI 执行,范围限定在该账号可访问的 CRM 对象读写,未见越权到系统级操作
② 联网外发——仅连接用户自己 HubSpot 账号的官方 API,目标透明
③ API Key——需设置环境变量 HUBSPOT_ACCESS_TOKEN(私有应用令牌)或走浏览器 OAuth 登录,为标准做法
④ 可疑指令——已读取的 SKILL.md 与配套资源文件内容清晰、逻辑单一,未见隐藏指令或混淆代码
⑤ 作者信誉——HubSpot 官方组织仓库,提交者均为可查的公司员工账号
⑥ License——Apache License 2.0,清晰
⑦ 维护时间——所属仓库近日仍有提交,整体处于持续维护状态
额外亮点:破坏性操作默认 --dry-run 预览,删除类批量操作需二次携带一次性 digest 确认才执行,并有 hubspot history 完整审计记录
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异化说明 |
|---|---|---|
| Stripe 官方最佳实践技能(stripe/ai) | 面向开发者的支付/订阅计费 API 集成最佳实践指南,教如何选型与写代码接入 Stripe | 定位是“从零搭建支付系统”的开发时指南;quote-to-cash 面向已在用 HubSpot 的运营人员,直接管理已存在的产品、报价、发票记录,无需写集成代码 |
| Airtable 官方技能包(Airtable/skills) | 通用结构化数据协作平台的官方 Agent 技能 | 不预置产品目录/报价单/订阅这类业务对象模型,需要自行搭建表结构;quote-to-cash 内建 HubSpot CRM 专属对象模型与破坏性操作安全范式 |
8. 用户评价
外部开发者 WesleyBLDC 在仓库 issue #5 中说明,将该仓库技能(含 quote-to-cash)安装进自己已有 50+ 技能的真实工作区后,遇到通用技能名与其他技能包命名冲突、难以在列表中辨识来源的问题,随后在个人 fork 上为全部技能加上 hubspot- 前缀重命名并更新了内部引用,并向上游提出可提交该改动的建议——反映出该技能已被外部用户实际安装并投入日常使用。
9. 其他补充
同一仓库下另有 14 个姊妹技能(如 deal-management、ticket-resolution、sales-reporting、bulk-operations 等),均依赖 bulk-operations 的分页与批量安全模式。
10. 安装使用方式
# 只安装 quote-to-cash 一个技能
npx skills hubspot/agent-cli-skills/quote-to-cash
# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills
安装后需配置 HubSpot 账号访问:设置环境变量 HUBSPOT_ACCESS_TOKEN(私有应用令牌,读取 invoices/subscriptions 需额外勾选 invoices-read/subscriptions-read 等 scope)或走浏览器 OAuth 登录。建议先安装并阅读 bulk-operations 技能了解 JSONL 管道与 dry-run/digest/confirm 流程。安装后无需重启,在对话中提及“create quote”“outstanding invoices”“active subscriptions”等触发词即可调用。
11. 注意事项
- CLI 创建的报价单状态始终为
DRAFT;报价审批路由、分享链接、PDF 生成与从零创建发票通常仍需回到 HubSpot 网页界面完成 invoices/subscriptions/orders/carts对象需要账号令牌具备对应读取 scope,否则请求会返回 403- 该子目录自 2026-05-26 首次提交后未见针对性的独立更新,稳定性以仓库整体持续维护为背景
- 仅在 Claude Code 环境验证过安装与触发路径,Codex / OpenClaw / Hermes Agent 兼容性未经验证