1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | workflow-automation-hubspot-agent-cli-skills |
| 作者/维护者 | HubSpot, Inc.（官方账号发布，主要提交者为具名员工 Brigitte Kawaguchi、Bryan Ash） |
| 来源链接 | https://github.com/HubSpot/agent-cli-skills/tree/main/workflow-automation |
| 许可证 | Apache License 2.0（GitHub API 获取） |
| GitHub Stars | 合集仓库整体 12（GitHub API 获取；该数字属整个合集仓库，不代表本技能自身热度，见评分说明） |
| Forks | 合集仓库整体 6（GitHub API 获取） |
| 最新版本 | 无独立版本号，随仓库滚动更新；该子技能最近一次实质性提交为 2026-06-25 |
| 安装方式 | npx skills hubspot/agent-cli-skills/workflow-automation（单独安装）或 npx skills hubspot/agent-cli-skills（安装全部 15 个子技能） |
2. 功能介绍与亮点
workflow-automation 让 Agent 通过 HubSpot 官方 Agent CLI（命令 hubspot，与用于搭建主题/模块的开发者 CLI hs 是两个不同工具）对 HubSpot 的 v4 workflows（自动化流程）做增删改查：
hubspot workflows list|get|create|update|delete覆盖流程的完整生命周期，list支持按名称模糊/精确匹配。- 内置三份资源文件：workflow JSON 结构参考、一个最小可用的联系人流程模板、一个演示“分支收敛”（多条分支指向同一个下游动作，避免重复搭建）的模板。
- 明确记录了实践中容易踩的坑：
create --dry-run只校验 JSON 格式合法性、不校验业务字段是否齐全；update是整体覆盖式 PUT，只传部分字段会把未传字段清空,必须先完整get再改。 - 破坏性操作（更新、删除）统一走“先 dry-run 出摘要 → 再带 digest 与 confirm 重新执行”的二次确认机制，删除后仍可通过
hubspot history查到操作记录用于恢复。 - 与同仓库的 bulk-operations 技能共享 JSONL 管道与分页处理约定，避免重复造轮子。
主要亮点：HubSpot 官方出品，且该子技能有一次专门的重构合并记录（合并 PR #2：“Refine workflow-automation skill, disambiguate hubspot vs hs CLI”），在同仓库 15 个子技能中提交次数（5 次）与专门维护记录都相对突出。
3. 适用场景
固定分类：集成与工作流自动化
已经在用 HubSpot 作为 CRM、且需要用 Agent 批量创建、审计或迁移营销/销售自动化流程（如迎新序列、线索分配规则）的团队，尤其适合需要脚本化管理流程（而非在 UI 里逐个点开编辑）的运营（RevOps）与营销自动化岗位；也适合需要把 HubSpot workflow 配置纳入版本控制、批量迁移到新账户的场景。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持 —— HubSpot 官方帮助文档明确列出。
- Codex：✅ 官方帮助文档明确列出 “OpenAI Codex” 为受支持平台。
- OpenClaw：❓ 未验证 —— 未见官方或第三方材料提及。
- Hermes Agent：❓ 未验证 —— 未见官方或第三方材料提及。
判断依据：HubSpot 官方帮助中心《Use the HubSpot Agent CLI》页面列出的受支持平台清单（另提及 Claude Cowork 与“许多其他兼容的 AI 编程 Agent”，但未点名 OpenClaw 或 Hermes Agent）。
5. 推荐理由
HubSpot 是主流上市 CRM 厂商，其官方 Agent CLI 于 2026 年 6 月进入公测，workflow-automation 是配套技能包里维护记录最扎实的一个：有专门合并的重构 PR、覆盖常见踩坑点的文档，并对更新/删除这类破坏性操作内置二次确认与历史回滚，工程质量在同类子技能里靠前，值得已用 HubSpot 的团队直接安装试用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7.0 | HubSpot 为官方一线 SaaS 厂商，但该子技能自身仅有 5 次提交与 1 个已合并的专项重构 PR，规模不大；合集仓库整体 12 stars 是整个合集的数字，不代表本技能自身热度 |
| 可用性 | 8.0 | 需先按官方文档安装 Agent CLI 并执行一次 hubspot auth login 授权，之后调用简洁；文档完整，含 3 个示例/参考资源文件与“dry-run 不校验请求体”等实操陷阱说明；最近一次实质性提交为 2026-06-25 |
| 安全性 | 9.0 | 见下方检查清单 |
安全检查清单
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅调用官方 hubspot CLI 既定子命令（workflows 的增删改查），不执行任意 shell，权限范围明确可解释 |
| ② 运行时联网外发 | 调用 HubSpot API 读写用户自己账户下的 workflow 数据，属预期功能而非隐蔽外发；同仓库另提供可选的 hubspot feedback 命令用于回传使用反馈，行为在文档中透明说明 |
| ③ API Key/凭据存储 | 通过官方 hubspot auth login 完成账户级授权登录，凭据由官方 CLI 自身托管，SKILL.md 本身不要求手工粘贴密钥 |
| ④ 可疑指令/注入迹象 | 未发现，正文仅为 CLI 用法说明 |
| ⑤ 作者/组织信誉 | HubSpot 为纽交所上市 SaaS 公司官方账号，提交者为具名员工 |
| ⑥ License | Apache License 2.0，明确 |
| ⑦ 最近维护时间 | 仓库整体最近一次提交为 2026-07-23，该子技能最近一次实质性提交为 2026-06-25 |
综合评分：8.0（三项均值）
7. 跟同类 Skills 相比的优势
| 维度 | workflow-automation（HubSpot Agent CLI） | n8n-workflow-lifecycle（n8n 官方） | workflows-create（Zapier 官方） |
|---|---|---|---|
| 定位 | 专为 HubSpot 自身 v4 workflows API 设计的 CRM 流程管理技能 | 通用自动化平台 n8n 的 workflow 搭建方法论，覆盖任意通过 MCP 连接的应用 | 把自然语言描述转成可测试、可发布的 Zapier 跨应用持久化工作流 |
| 依赖账户 | 只需 HubSpot 自身账户，无需额外平台 | 依赖 n8n 实例及其已连接的第三方节点 | 依赖 Zapier 平台账户及其已连接的第三方应用 |
| 安全/纠错设计 | 更新/删除内置 dry-run + digest + confirm 三重确认，删除后可 hubspot history 回溯 |
六阶段方法论配合 hook 自动路由，侧重防止流程“看似正确、生产环境翻车” | 生成的工作流可先测试再发布，侧重结果可验证 |
| 覆盖广度 vs 深度 | 只覆盖 HubSpot 一款 CRM，但对其 workflow 模型（分支收敛、revisionId 版本控制）建模更深 | 覆盖任意 n8n 可连接的应用，广度换深度 | 覆盖任意 Zapier 已连接的应用，广度换深度 |
8. 用户评价
该技能所在的 HubSpot Agent CLI 技能包已有真实外部开发者在议题区参与反馈——GitHub 用户 WesleyBLDC 提出“技能工作区已有很多技能时，技能名称不易被快速扫描识别”的可用性建议（该议题截至目前尚无跟帖讨论）。workflow-automation 本身目前尚无第三方平台的具名独立评价。
9. 其他补充
同仓库另有 2 个开放中的 Pull Request（新增 build-targeting-foundation、crm-query/crm-reports 等技能），以及一个探索 Claude Cowork / ChatGPT 插件清单适配的开放 PR，显示该技能包仍在持续扩充中。
10. 安装使用方式
- 安装 HubSpot Agent CLI 本体：
- macOS / Linux / WSL：
curl -fsSL https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.sh | sh - Windows PowerShell：
irm https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.ps1 | iex
- macOS / Linux / WSL：
- 执行
hubspot auth login完成 HubSpot 账户授权（交互式，会展示权限范围供确认）。 - 安装该技能：
npx skills hubspot/agent-cli-skills/workflow-automation（或安装整套 15 个技能：npx skills hubspot/agent-cli-skills），默认装入项目的.claude/skills/目录。 - 安装后无需重启，Agent 在对话中出现“workflow / automation / enrollment trigger”等触发词时会自动加载；首次使用建议先
get一个已有 workflow 作为编辑模板，而不是手写 JSON 从零开始。
11. 注意事项
- 强依赖同仓库的 bulk-operations 技能（JSONL 管道与分页/dry-run 约定），建议两者一并安装。
update为整体覆盖式 PUT，遗漏字段会被清空，必须先完整get再改，不能只传增量字段。- 没有
hubspot workflows search命令，按名称查找需自行list | jq过滤。 - 没有 Lists API，基于静态列表成员的 enrollment trigger 仍需在 HubSpot 界面里配置。
- HubSpot Agent CLI 整体处于公测（Beta）阶段（2026 年 6 月启动公测），并非正式 GA 版本，接口行为可能变化。
- OpenClaw、Hermes Agent 的兼容性未获验证，使用前建议自行试装确认。