sales-execution-hubspot-agent-cli-skills

1. 基本信息

项目	内容	数据来源
名称	sales-execution-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-execution	—
许可证	Apache License 2.0	GitHub API
GitHub Stars / Forks	18 / 7（合集仓库整体口径，含 15 个子技能，不代表本技能个体热度；本技能自身在 skills.sh 上有 843 次独立安装记录，见第 6 章）	GitHub API；skills.sh
最新版本	无正式版本标签，持续滚动提交	GitHub API
安装方式	`npx skills hubspot/agent-cli-skills/sales-execution`（单装）或 `npx skills hubspot/agent-cli-skills`（全装 15 个技能）	官方 README

2. 功能介绍与亮点

sales-execution 教编程 Agent 用官方 hubspot CLI 把通话、笔记、会议、跟进任务记录到 CRM 联系人/交易记录上，核心是把两条容易踩坑的隐藏规则显式写清楚：

“创建即写完”是假象：hubspot objects create --type calls ... 单独执行会生成一条 CRM UI 上完全看不见的孤儿记录，必须紧跟 hubspot associations create --from calls:<id> --to contacts:<id>（如涉及交易还要再关联一次）才算真正写完。这条规则被单列一节强调，避免 Agent 误以为创建成功即代表用户能在 CRM 里看到记录
写入路径与读取路径的时间戳格式不同：写入用 Unix 毫秒（13 位数字），而 activities list 读回的是顶层 ISO 8601 字符串——两条路径拿到的同一份数据，字段格式并不一致，文档用表格逐路径列出，避免误用
按类型给出可直接运行的创建+关联命令模板：CALL/NOTE/MEETING/TASK 四种类型分别列出准确的属性名与枚举值（如 hs_call_direction、hs_meeting_outcome、hs_task_priority），任务类型额外提醒 hs_timestamp 在这里代表到期时间而非创建时间，与其他类型语义不同
批量跟进任务的 ID 对齐手法：为某阶段下的全部交易批量创建跟进任务时，用 paste 把交易 ID 与新建任务 ID 按行拼接后再批量建立关联，避免批量创建后 ID 顺序错位导致关联到错误的交易

亮点：官方一线 CRM 厂商出品；把“写入成功≠用户可见”这类隐蔽失败模式明确点破，而非留给用户自己踩坑发现；对每种活动类型的属性名与枚举值给出可复制的真实示例而非泛泛描述。

3. 适用场景

所属分类：集成与工作流自动化（该技能的核心是把交互记录写入第三方 CRM 服务并处理其关联关系，属于对外部业务系统的操作型集成；用 --neighbors 核对“CRM 活动记录关联”关键词，12 条命中中 8 条落在本分类，其余多为字面噪音，与本技能的同仓库姊妹技能高度一致）

销售或客服代表通话、开会、发送提案后需要把互动过程写回 CRM 并让团队其他人（尤其是交易的其他相关方）能在 CRM 里看到的场景；也适合需要脚本化批量为多条交易创建跟进任务的销售运营团队。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——README 明确列出，默认安装到项目 .claude/skills/ 目录
Codex：❓ 未验证——已抓取材料未点名提及
OpenClaw：❓ 未验证——已抓取材料未点名提及
Hermes Agent：❓ 未验证——已抓取材料未点名提及

（README 另提及 Cursor、Windsurf 等其他编程 Agent 兼容，但不在本报告评估范围内）

5. 推荐理由

“创建记录却不关联导致用户在 CRM 里什么都看不到”是这类 CLI 集成里最容易被忽略、代价却很高的一类错误——Agent 会认为任务已完成，而用户端毫无痕迹。这个技能把这条隐藏规则和读写时间戳格式不一致这个次生陷阱一起显式写进文档，并为四种活动类型各自提供准确的属性名与批量关联的 ID 对齐手法，能让 Agent 在真实 CRM 环境中一次性、正确地完成活动记录与跟进任务创建，减少“看似成功实则无效”的静默失败。

6. 评分

维度	分数	说明
受欢迎程度	7	官方 HubSpot 仓库出品；skills.sh 平台统计该技能独立安装量为 843 次，落在同仓库 15 个子技能的主聚集区间内
可用性	8	单文件 SKILL.md 完整覆盖四种活动类型的创建、关联、批量跟进任务三类操作，均配可直接运行的命令示例；依赖同仓库 `bulk-operations` 的分页与批处理机制作为前置阅读；仓库近期仍有提交，维护活跃
安全性	9	见下方检查清单

安全检查清单：

① Shell 命令及权限范围——通过官方 hubspot CLI 执行，范围限定在该账号可访问的通话/笔记/会议/任务对象的创建与关联 ② 联网外发——仅连接用户自己 HubSpot 账号的官方 API，目标透明 ③ 凭据——设置环境变量 HUBSPOT_ACCESS_TOKEN 或走浏览器 OAuth 登录，为标准做法，凭据不写入仓库 ④ 可疑指令——SKILL.md 内容清晰、逻辑单一，未见隐藏指令或混淆代码 ⑤ 作者信誉——HubSpot 官方组织仓库，该 CLI 为其官方公开 Beta 产品 ⑥ License——Apache License 2.0，清晰 ⑦ 维护时间——仓库最近仍有提交，非弃置项目额外亮点：明确指出“创建但不关联”这种表面成功、实则用户不可见的静默失败模式，并给出批量场景下 ID 对齐的具体做法，而非事后才让用户自行发现关联缺失

7. 跟同类 Skills 相比的优势

方案	定位	差异化说明
HubSpot 官方远程 MCP Server（mcp.hubspot.com）	面向对话式 AI 助手的托管接入点，支持自然语言查改单条 CRM 对象	定位是“对话里改一条”；sales-execution 面向脚本化/批量场景，内建创建+关联的强制顺序规则与批量 ID 对齐手法，适合成批记录多条活动或跟进任务
TomGranot/hubspot-admin-skills（第三方社区项目，37 个技能，MIT 协议）	覆盖更广的 HubSpot 数据治理套件，含多类管理员级操作模块，基于 Python 脚本 + REST API	sales-execution 由 HubSpot 官方发布、直接建立在官方 `hubspot` CLI 之上，命令行为一等公民，无需额外 Python 运行环境；聚焦“活动记录与跟进任务”单一操作面，而非覆盖治理全流程的大而全套件

8. 用户评价

第三方博客 AI Builder Club（作者 Shirley，2026-06-11 发布）在介绍 Claude Code 销售场景技能栈的文章中，把 sales-execution 与该仓库其他 CRM 技能一起列入“Stage 4：CRM 操作”环节，标注其功能为“记录通话、笔记、会议与任务到联系人和交易”，并将这批 HubSpot 官方技能整体定位为面向习惯在终端里完成 CRM 操作的用户。文章未对 sales-execution 单独给出优劣评价，评价停留在功能罗列与厂商官方背书层面。

除此之外，该技能目前在第三方平台尚无更多具名用户评价。

9. 其他补充

同一仓库下另有 14 个姊妹技能（如 bulk-operations、crm-lookup、deal-management、data-enrichment 等），均依赖 bulk-operations 的分页与批量安全模式。

10. 安装使用方式

# 只安装 sales-execution 一个技能
npx skills hubspot/agent-cli-skills/sales-execution

# 安装全部 15 个技能
npx skills hubspot/agent-cli-skills

安装后需配置 HubSpot 账号访问：设置环境变量 HUBSPOT_ACCESS_TOKEN（私有应用令牌）或走浏览器 OAuth 登录。建议先安装并阅读 bulk-operations 技能了解 JSONL 管道与批处理约定。安装后无需重启，在对话中提及 “log a call”、“log a note”、“create task”、“follow-up task” 等触发词即可调用。

11. 注意事项

依赖官方 hubspot Agent CLI（与开发 HubSpot 应用的 hs/@hubspot/cli 是两个不同工具），需单独安装
创建活动记录后必须显式执行关联调用，否则记录在 CRM UI 中不可见——这是文档明确写出的已知行为，而非疏漏
枚举属性的可选值不由 properties get 直接暴露，需从参考文件或真实记录核实
CLI 目前不支持销售 sequences/cadences 功能