SkillsScout
INTEGRATION-WORKFLOW ／ 集成与工作流自动化

communication-history-hubspot-agent-cli-skills

收录日期 2026-08-04·来源仓库 ↗
受欢迎程度
7
可用程度与相关性
8
安全性
9
8.0SCOUT SCORE

1. 基本信息

项目 内容 数据来源
名称 communication-history-hubspot-agent-cli-skills —
项目自述名称 HubSpot Agent CLI Skills（合集仓库自身名） GitHub README
作者/维护者 HubSpot（CRM/营销 SaaS 厂商），官方组织仓库 GitHub API
来源链接 https://github.com/HubSpot/agent-cli-skills/tree/main/communication-history —
许可证 Apache License 2.0 GitHub API
GitHub Stars / Forks 18 / 7（合集仓库整体口径，含 15 个子技能，不代表本技能个体热度；本技能自身在 skills.sh 上有 851 次独立安装记录，见第 6 章） GitHub API；skills.sh
最新版本 无正式版本标签，持续滚动提交 GitHub API
安装方式 npx skills hubspot/agent-cli-skills/communication-history（单装）或 npx skills hubspot/agent-cli-skills（全装 15 个技能） 官方 README

2. 功能介绍与亮点

communication-history 教编程 Agent 用官方 hubspot CLI 从 CRM 记录中拉取通话、邮件、笔记、会议、任务这五类活动的历史数据，并组装成可直接使用的通话前简报，核心亮点：

亮点：官方一线 CRM 厂商出品；该技能仅涉及数据读取，不包含任何创建、更新或删除操作；把两条读取路径的格式差异这类容易被忽略的细节显式写清楚，而非留给使用者自行踩坑发现。

3. 适用场景

所属分类：集成与工作流自动化（该技能的核心是从第三方 CRM 服务读取并聚合活动数据，属于对外部业务系统的操作型集成；用 --neighbors 核对“CRM 活动历史 通话记录 客户沟通”关键词，10 条命中全部落在本分类，与本技能的同仓库姊妹技能高度一致）

销售或客服代表在通话、会议前需要快速调阅联系人历史互动记录并生成简报的场景；也适合需要批量导出通话转录文本做离线分析或归档的团队。

4. 跨 Agent 兼容性

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

5. 推荐理由

通话或会议前手动翻找联系人在 CRM 里的历史互动记录是销售与客服团队的高频重复劳动，而两条读取路径（扁平活动列表与原始对象字段）时间戳格式不一致这个细节，如果 Agent 没被提前告知，很容易在做时间过滤时悄悄用错格式而得到错误结果却毫无报错提示。这个技能把该陷阱、批量取数应避免逐条请求的原则，以及组装通话前简报的完整管道一次性写清楚，还额外覆盖了批量导出通话转录文本这一独立场景，让 Agent 能一次性、正确地完成信息聚合，减少静默出错的返工成本。

6. 评分

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

安全检查清单：

① Shell 命令及权限范围——通过官方 hubspot CLI 执行，全部为只读命令（activities list、objects get、associations list、transcript get），不涉及任何创建/更新/删除操作 ② 联网外发——仅连接用户自己 HubSpot 账号的官方 API，目标透明 ③ 凭据——设置环境变量 HUBSPOT_ACCESS_TOKEN 或走浏览器 OAuth 登录，为标准做法，凭据不写入仓库 ④ 可疑指令——SKILL.md 内容清晰、逻辑单一，未见隐藏指令或混淆代码 ⑤ 作者信誉——HubSpot 官方组织仓库，该 CLI 为其官方公开 Beta 产品 ⑥ License——Apache License 2.0，清晰 ⑦ 维护时间——仓库最近仍有提交，非弃置项目 额外亮点：本技能是同仓库 15 个子技能中少数完全不涉及写操作的一个，读取路径格式不一致这类隐蔽陷阱被显式文档化，而非留给使用者事后发现。

7. 跟同类 Skills 相比的优势

方案 定位 差异化说明
HubSpot 官方远程 MCP Server（mcp.hubspot.com） 面向对话式 AI 助手的托管接入点，支持自然语言查询单条 CRM 对象 定位是“对话里问一条”；communication-history 面向脚本化批量聚合场景，内建四段式简报组装管道与批量转录导出，适合一次性拉取多个关联对象或全量导出转录文本
TomGranot/hubspot-admin-skills（第三方社区项目，37 个技能，MIT 协议） 覆盖更广的 HubSpot 数据治理套件，含多类管理员级操作模块，基于 Python 脚本 + REST API communication-history 由 HubSpot 官方发布、直接建立在官方 hubspot CLI 之上，命令行为一等公民，无需额外 Python 运行环境；聚焦“活动历史检索与简报组装”单一读取场景，而非覆盖治理全流程的大而全套件

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。GitHub Issue #5（用户 WesleyBLDC，2026 年提交，状态开放）反馈整个仓库 15 个子技能（含本技能）的命名过于通用——communication-history、crm-lookup 等名称不带 hubspot 前缀，在已安装 50+ 技能的工作区中难以分辨归属，容易与其他技能包混淆；该用户已在自己的 fork 中为全部技能加前缀重命名并提交上游 PR，供维护者参考采纳。

9. 其他补充

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

10. 安装使用方式

# 只安装 communication-history 一个技能
npx skills hubspot/agent-cli-skills/communication-history

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

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

11. 注意事项