1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | ticket-resolution-hubspot-agent-cli-skills | — |
| 项目自述名称 | HubSpot Agent CLI Skills(合集仓库自身名) | GitHub README |
| 作者/维护者 | HubSpot(CRM/营销 SaaS 厂商),官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/HubSpot/agent-cli-skills/tree/main/ticket-resolution | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars / Forks | 18 / 7(合集仓库整体口径,含 15 个子技能,不代表本技能个体热度;本技能自身在 skills.sh 上有 1,100 次独立安装记录,是同仓库 15 个子技能中最高的一个,见第 6 章) | GitHub API;skills.sh |
| 最新版本 | 无正式版本标签,持续滚动提交 | GitHub API |
| 安装方式 | npx skills hubspot/agent-cli-skills/ticket-resolution(单装)或 npx skills hubspot/agent-cli-skills(全装 15 个技能) |
官方 README |
2. 功能介绍与亮点
ticket-resolution 教编程 Agent 通过官方 hubspot CLI 走完支持工单的完整生命周期:
- 流水线与阶段发现:管道、阶段 ID 均按账号动态查询,不硬编码,同一份指令能跨门户复用
- 枚举值探测:优先级、类别、解决方式等下拉字段的可选值不走标准 API,技能给出两条替代路径——故意提交非法值从错误里读出允许选项,或直接读真实记录里已在用的取值
- 创建即关联:工单创建后必须显式关联到联系人/公司,否则在 CRM 界面里“存在但看不见”——这条隐藏规则被直接写进了文档
- 批量分诊与推进:按优先级/负责人筛选未处理工单,批量改阶段或转派;超过 100 条自动进入二次确认流程
- 关闭与统计:写入解决方式后,关闭状态、关闭时间、解决耗时均由 HubSpot 自动计算
亮点:官方一线 CRM 厂商出品;建立在同仓库 bulk-operations 基础技能之上,复用其安全写入闸门;文档把“枚举值探测”这类要靠踩坑才知道的细节直接写了出来。
3. 适用场景
所属分类:集成与工作流自动化
已使用 HubSpot 支持工单模块的客服/客户支持团队,或负责工单积压清理、按优先级批量分诊、批量转派负责人的运营人员,想让 Agent 直接完成这些重复性支持工作,而不用自己在网页端逐条点击或拼接 HubSpot API 的分页与鉴权逻辑。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 明确列出,默认安装到项目
.claude/skills/目录 - Codex:❓ 未验证——已抓取材料未点名提及
- OpenClaw:❓ 未验证——已抓取材料未点名提及
- Hermes Agent:❓ 未验证——已抓取材料未点名提及
(README 另提及 Cursor、Windsurf 等其他编程 Agent 兼容,但不在本报告评估范围内)
5. 推荐理由
工单处理是几乎所有面向客户团队都会遇到的高频重复劳动,而这个技能把“枚举值不可见”“创建后不关联就等于没建”这些容易踩的坑直接写进了文档,配合同仓库统一的批量安全写入闸门,能让 Agent 在真实 CRM 数据上可靠地完成分诊到关闭的全流程。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方 HubSpot 仓库出品;skills.sh 平台统计其独立安装量 1,100 次,是同仓库 15 个子技能中最高的一个 |
| 可用性 | 8 | 单文件 SKILL.md 完整覆盖流水线发现、枚举探测、创建关联、批量分诊、批量推进、关闭统计全流程;依赖同仓库 bulk-operations 的分页/dry-run 机制;仓库近期仍有提交,维护活跃 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:
① Shell 命令及权限范围——通过官方 hubspot CLI 执行,范围限定在该账号可访问的工单/联系人/公司对象读写
② 联网外发——仅连接用户自己 HubSpot 账号的官方 API,目标透明
③ 凭据——设置环境变量 HUBSPOT_ACCESS_TOKEN 或走浏览器 OAuth 登录,为标准做法,凭据不写入仓库
④ 可疑指令——SKILL.md 内容清晰、逻辑单一,未见隐藏指令或混淆代码
⑤ 作者信誉——HubSpot 官方组织仓库,该 CLI 为其官方公开 Beta 产品
⑥ License——Apache License 2.0,清晰
⑦ 维护时间——仓库最近仍有提交,非弃置项目
额外亮点:批量更新默认先 --dry-run 预览,超过 100 行需 digest 二次确认才执行,并有 history 记录可回溯
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异化说明 |
|---|---|---|
| HubSpot 官方远程 MCP Server(mcp.hubspot.com) | 面向对话式 AI 助手的托管接入点,支持自然语言查改工单等 CRM 对象 | 定位是“对话里查改一条”;ticket-resolution 面向批量脚本场景,内建流水线发现、枚举探测、批量分诊与可回溯的 history |
| Freshdesk Automation(第三方,经 MCP 中转服务器接入) | 创建/更新工单、跨历史检索、客户记录管理 | 需额外部署维护一层 MCP 中转服务;ticket-resolution 由厂商自己发布、可直接 npx 安装,少一层部署环节 |
8. 用户评价
在同一 HubSpot 仓库的 GitHub Issues 中,用户 WesleyBLDC 分享了真实安装体验:其 Agent 工作区已装有 50 多个来自其他技能包的 skill,bulk-operations、quote-to-cash 等通用命名的技能不带来源前缀,扫描时难以分辨归属,存在潜在命名冲突。该用户在本地 fork 里为全部技能加上 hubspot- 前缀重命名,解决了可发现性问题,并向上游提出了合并请求。这条反馈适用于同仓库下包括 ticket-resolution 在内的全部技能,安装到已有大量技能的工作区时可留意命名冲突。
除此之外,该技能目前在第三方平台尚无更多具名用户评价。
9. 其他补充
同一仓库下另有 14 个姊妹技能(如 deal-management、quote-to-cash、sales-execution、bulk-operations 等),均依赖 bulk-operations 的分页与批量安全模式。
10. 安装使用方式
# 只安装 ticket-resolution 一个技能
npx skills hubspot/agent-cli-skills/ticket-resolution
# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills
安装后需配置 HubSpot 账号访问:设置环境变量 HUBSPOT_ACCESS_TOKEN(私有应用令牌)或走浏览器 OAuth 登录。建议先安装并阅读 bulk-operations 技能了解 JSONL 管道与 dry-run/digest/confirm 流程。安装后无需重启,在对话中提及 “create ticket”、“triage tickets”、“resolve ticket” 等触发词即可调用。
11. 注意事项
- 依赖官方
hubspotAgent CLI(与开发 HubSpot 应用的hs/@hubspot/cli是两个不同工具),需单独安装 - 下拉枚举字段的可选值因账户配置而异,标准 API 不返回选项列表,需逐账户按文档方法探测
- 目前没有 Conversations/Inbox API 支持,聊天类工单与收件箱邮件不在覆盖范围内
- 批量更新、转派等操作不可逆,虽有二次确认机制,仍建议先在小范围数据上试跑