1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | bulk-operations-hubspot-agent-cli-skills | — |
| 项目自述名称 | HubSpot Agent CLI Skills（合集仓库自身名） | GitHub README |
| 作者/维护者 | HubSpot（CRM/营销 SaaS 厂商），官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/HubSpot/agent-cli-skills/tree/main/bulk-operations | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars | 12（合集仓库整体，含 15 个子技能，不代表本技能个体热度） | GitHub API |
| Forks | 6 | GitHub API |
| 最新版本 | 无正式版本标签，持续滚动提交 | GitHub API |
| 安装方式 | npx skills hubspot/agent-cli-skills/bulk-operations（单装）或 npx skills hubspot/agent-cli-skills（全装 15 个技能） |
官方 README |
2. 功能介绍与亮点
bulk-operations 是 HubSpot 官方 agent-cli-skills 仓库中的基础技能，教编程 Agent 通过官方 hubspot 命令行工具批量读写 CRM 数据。核心能力：
- JSONL 流水线：
list/search/get输出逐行 JSON，create/update/upsert/delete/merge从标准输入接收同样格式，天然可与jq组合做数据整形； - 批量优先：内置分页脚本
pagination-loop.sh自动翻页收集全部记录，避免逐条调用 CLI 进程； - 破坏性操作三段式保护：
--dry-run预览 → 超过 100 条记录时生成一次性digest→ 必须携带--digest与--confirm在 5 分钟内重新执行才会真正生效； - 操作可追溯：
hubspot history记录所有破坏性操作与其预览，便于事后审计与人工找回。
仓库同名下另有 14 个姊妹技能（联系人分群、销售报表、工单处理、工作流管理等），bulk-operations 是其余技能共用的基础模式，最近一次专属提交为暴露 hubspot feedback --source agent 反馈通道，显示持续迭代而非一次性发布后停摆。
3. 适用场景
所属分类：集成与工作流自动化
已经把 HubSpot 作为 CRM/营销运营中枢的团队，想让编程 Agent 直接批量整理、更新或清洗联系人、公司、交易等记录，而不必逐条手动操作 HubSpot 界面，也不必自己封装 HubSpot REST API 的分页与鉴权逻辑。同一仓库内其余 14 个技能覆盖更具体的销售、客服、营销场景，bulk-operations 是使用它们的前置基础。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README 明确将 Claude Code 列为受支持 Agent，默认安装路径为项目
.claude/skills/目录 - Codex：❓ 未验证——已抓取材料未点名提及
- OpenClaw：❓ 未验证——已抓取材料未点名提及
- Hermes Agent：❓ 未验证——已抓取材料未点名提及
（README 另提及 Cursor、Windsurf 等其他编程 Agent 兼容，但不在本报告评估范围内）
5. 推荐理由
HubSpot 官方亲自维护的 CRM 批量操作技能，把“分页-整形-预览-确认-可追溯”这套安全的批量数据操作范式直接教给编程 Agent，省去团队自行摸索 HubSpot API 分页与破坏性操作防护的过程。对已在用 HubSpot 的销售/运营团队而言，是把编程 Agent 接入日常 CRM 数据清洗与批量维护工作最省心的官方路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | HubSpot 为纽交所上市 SaaS 公司官方出品；仓库本身星标不高，但已有外部用户在 issue 中描述将其安装进含 50+ 技能的真实工作区并提出改进建议，属实际采用的具体证据 |
| 可用性 | 8 | 支持整包或单技能安装；文档含完整命令示例、JSON 整形范式与故障处理说明；bulk-operations 自身有 3 次独立提交且最近一次在近一个月内，仓库另有多个进行中的功能分支；需先配置 HubSpot 账号访问令牌 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① Shell 命令及权限范围——通过官方 hubspot CLI 执行，范围限定在该账号可访问的 CRM 对象读写，未见越权到系统级操作
② 联网外发——仅连接用户自己 HubSpot 账号的官方 API，目标透明
③ API Key——需设置环境变量 HUBSPOT_ACCESS_TOKEN（私有应用令牌）或走浏览器 OAuth 登录，为标准做法
④ 可疑指令——已读取的 SKILL.md 与配套 pagination-loop.sh 脚本内容清晰、逻辑单一，未见隐藏指令或混淆代码
⑤ 作者信誉——HubSpot 官方组织仓库，提交者均为可查的公司员工账号
⑥ License——Apache License 2.0，清晰
⑦ 维护时间——bulk-operations 最近一次专属提交在近一个月内，仓库整体近日仍有提交
额外亮点：破坏性操作默认要求 --dry-run 预览，批量操作需二次携带一次性 digest 确认才执行，并有 hubspot history 完整审计与找回记录，安全设计优于同类技能的一般水准
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异化说明 |
|---|---|---|
| Airtable 官方技能包（Airtable/skills） | 通用结构化数据平台的官方 Agent 技能，含 CRM/营销/产品运营模式参考 | 面向“自建表格结构”的通用数据协作平台，不绑定具体 CRM 业务模型；无内置的破坏性操作二次确认与 digest 机制 |
| Zapier SDK 官方技能（zapier/sdk） | 通过 Zapier 托管的 OAuth 层调用 9,000+ 应用的单个动作 | 定位是“跨应用触发具体动作”，按次调用、无批量分页与 JSONL 流水线设计；不针对 CRM 数据模型做深度建模 |
| 直接调用 HubSpot REST API（无 Skill 封装） | 开发者自行查阅官方 API 文档、手写分页与鉴权 | 没有内置的批量安全防护（dry-run/digest/history），每个新会话都要重新处理分页与限流逻辑 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；仓库自身 issue 区有外部用户描述了将其安装进已有 50+ 技能的工作区后遇到的命名可辨识度问题，并提交了改进方案。
9. 其他补充
同一仓库下另有 14 个姊妹技能（如 deal-management、ticket-resolution、sales-reporting、workflow-automation 等），均依赖 bulk-operations 的分页与批量模式；仓库设有多个进行中的功能分支（如新增 CRM 查询、目标客户识别相关技能），显示持续扩展。
10. 安装使用方式
# 只安装 bulk-operations 一个技能
npx skills hubspot/agent-cli-skills/bulk-operations
# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills安装后注意事项：需先安装并登录官方 hubspot CLI，设置 HUBSPOT_ACCESS_TOKEN（私有应用令牌）或完成浏览器 OAuth 登录；技能会在会话开始时建议先运行 hubspot objects types 查看当前账号的标准与自定义对象类型；无需重启 Agent，安装完成即可在对话中触发。
11. 注意事项
- 需要一个 HubSpot 账号（含免费版）才能实际使用，纯为学习 CLI 用法而无 HubSpot 账号的用户无法验证效果
- 部分破坏性操作在浏览器 OAuth 登录下可能被 HubSpot 平台权限拦截，需改用私有应用令牌运行
- 该 CLI 与 HubSpot 开发者工具
@hubspot/cli（hs命令）是两个不同工具，不要混淆 - Codex / OpenClaw / Hermes Agent 的兼容性未经验证，官方文档未点名