1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | deal-management-hubspot-agent-cli-skills | — |
| 项目自述名称 | HubSpot Agent CLI Skills(合集仓库自身名) | GitHub README |
| 作者/维护者 | HubSpot(CRM/营销 SaaS 厂商),官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/HubSpot/agent-cli-skills/tree/main/deal-management | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars | 18(合集仓库整体,含 15 个子技能,不代表本技能个体热度) | GitHub API |
| Forks | 7 | GitHub API |
| 最新版本 | 无正式版本标签,持续滚动提交 | GitHub API |
| 安装方式 | npx skills hubspot/agent-cli-skills/deal-management(单装)或 npx skills hubspot/agent-cli-skills(全装 15 个技能) |
官方 README |
2. 功能介绍与亮点
deal-management 教编程 Agent 通过官方 hubspot CLI 完成销售交易(deal)的完整生命周期管理:
- 管道与阶段发现:管道 ID、阶段 ID 均按账号运行时动态获取,不硬编码——同一份指令能跨不同 HubSpot 门户复用
- MQL 转化为交易:查找已建立联系但尚无交易的市场合格线索(MQL),建交易、关联联系人与公司、推进生命周期阶段,并给出单条与批量两种路径;批量路径特别处理了“先建交易、再按行号配对做关联”的两阶段管道陷阱
- 批量推进与转移:按阶段/负责人批量移动交易或改派负责人,复用同仓库
bulk-operations的 JSONL 管道与 dry-run 预览 - 停滞交易巡检:内置基于动态日期的筛选配方(如“30 天无活动的未结交易”),可直接接入后续的批量更新或建任务流程
- 结单:按阶段+关闭日期完成赢单/输单,并说明
hs_is_closed等字段为系统只读、需通过阶段变更间接触发
SKILL.md 附带两份专用参考资源(生命周期阶段推进对照表、停滞交易查询配方),并在正文明确标注已知限制(批量 MQL 转交易必须分两步 shell 调用、lifecyclestage 多数门户配置下不可逆向回退)。
3. 适用场景
所属分类:集成与工作流自动化
已使用 HubSpot CRM 的销售运营人员或销售代表,想让编程 Agent 批量把市场线索转化为交易、按阶段/负责人批量推进交易、揪出停滞交易并结单,省去手工在网页端逐条操作或自行拼接 HubSpot REST API 的分页与鉴权逻辑。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 明确列出,默认安装到项目
.claude/skills/目录 - Codex:❓ 未验证——已抓取材料未点名提及
- OpenClaw:❓ 未验证——已抓取材料未点名提及
- Hermes Agent:❓ 未验证——已抓取材料未点名提及
(README 另提及 Cursor、Windsurf 等其他编程 Agent 兼容,但不在本报告评估范围内)
5. 推荐理由
HubSpot 官方维护,把交易生命周期里最容易出错的几个环节——管道/阶段跨门户不通用、批量建交易时关联关系错位、只读字段误写——直接教给 Agent,并继承同仓库经过验证的批量安全操作范式,让已用 HubSpot 的销售运营团队能放心把交易管理交给 Agent 批量处理。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | HubSpot 为官方出品;仓库 issue 区有外部用户在其含 50+ 技能的真实工作区中安装并使用了该合集下的多个技能,属实际采用的具体证据 |
| 可用性 | 8 | 一条命令单装或全装;SKILL.md 含分步命令示例、两份专用参考资源文件与显式“已知限制”章节;所属仓库近期仍有提交维护 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:
① Shell 命令及权限范围——通过官方 hubspot CLI 执行,范围限定在该账号可访问的交易/联系人/公司对象读写,未见越权到系统级操作
② 联网外发——仅连接用户自己 HubSpot 账号的官方 API,目标透明
③ API Key——需设置环境变量 HUBSPOT_ACCESS_TOKEN(私有应用令牌)或走浏览器 OAuth 登录,为标准做法
④ 可疑指令——已读取的 SKILL.md 与配套资源文件内容清晰、逻辑单一,未见隐藏指令或混淆代码
⑤ 作者信誉——HubSpot 官方组织仓库,提交者均为可查的公司员工账号
⑥ License——Apache License 2.0,清晰
⑦ 维护时间——所属仓库近日仍有提交,整体处于持续维护状态
额外亮点:批量更新操作默认先 --dry-run 预览,超过 100 行需二次携带一次性 digest 确认才执行,并有 hubspot history 完整审计记录可回溯
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异化说明 |
|---|---|---|
| HubSpot 官方远程 MCP Server(mcp.hubspot.com) | 面向对话式 AI 助手的托管 MCP 接入点,支持自然语言读写联系人、交易、工单等 CRM 对象 | 定位是“对话中临时查一笔/改一条”的交互式接入;deal-management 面向批量脚本化场景,内建 JSONL 管道、dry-run/digest 二次确认与 hubspot history 回滚,适合一次处理成百上千条交易 |
| Airtable 官方技能包(Airtable/skills) | 通用结构化数据协作平台的官方 Agent 技能 | 不预置销售管道/交易阶段/生命周期这类业务对象模型,需要自行搭建表结构;deal-management 内建 HubSpot 交易对象模型与阶段推进的正确调用顺序 |
8. 用户评价
外部开发者在仓库 issue #5 中说明,将该仓库的技能安装进自己已有 50+ 技能的真实工作区后,遇到 bulk-operations、crm-lookup、quote-to-cash 等通用命名与其他技能包冲突、难以在列表中辨识来源的问题,随后在个人 fork 上为全部技能加上 hubspot- 前缀重命名并更新了内部引用,并向上游提出可提交该改动的建议——反映出该合集下的技能已被外部用户实际安装并投入日常使用。
9. 其他补充
同一仓库下另有 14 个姊妹技能(如 quote-to-cash、ticket-resolution、sales-reporting、bulk-operations 等),均依赖 bulk-operations 的分页与批量安全模式。
10. 安装使用方式
# 只安装 deal-management 一个技能
npx skills hubspot/agent-cli-skills/deal-management
# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills
安装后需配置 HubSpot 账号访问:设置环境变量 HUBSPOT_ACCESS_TOKEN(私有应用令牌)或走浏览器 OAuth 登录。建议先安装并阅读 bulk-operations 技能了解 JSONL 管道与 dry-run/digest/confirm 流程。安装后无需重启,在对话中提及“create deal”“stalled deals”“close deal”等触发词即可调用。
11. 注意事项
- 批量把 MQL 转为交易需要两段式 shell 流程:关联关系必须依据
objects create的返回结果建立,不能塞进同一条管道 lifecyclestage在多数门户设置下只能前进、不可回退- 无原生的销售跟进节奏/序列(sequence/cadence)能力,需搭配
sales-execution技能建后续任务 - 该子目录自 2026-05-26 首次提交后未见针对性的独立更新,稳定性以仓库整体持续维护为背景
- 仅在 Claude Code 环境验证过安装与触发路径,Codex / OpenClaw / Hermes Agent 兼容性未经验证