在终端用 HubSpot CLI 生成销售日报…

需要从 HubSpot CRM 快速生成每日简报、按阶段/负责人查看开放管道，或统计赢单率与月度收入时适用。

适用场景

解决思路

1. 以 `hubspot <command> --help` 为权威用法；构建在 `bulk-operations/SKILL.md` 上，复用其中的 JSONL 形状、批量读取规则和分页规则，重塑模式参考 `bulk-operations/resources/json-patterns.md`。
2. `search`/`list` 每次最多返回 100 行；结果恰好 100 行几乎总是被截断，聚合前先按 `bulk-operations/SKILL.md` 分页。
3. 所有 CRM 属性值在 JSONL 中都返回字符串，布尔值也是；`hs_is_closed_won` 返回 `"true"`/`"false"` 字符串，`amount` 是数字字符串。做算术用 `tonumber`；客户端过滤布尔时按字符串比较 `== "true"`。
4. 在 `--filter` 表达式中，`hs_is_closed_won=true` 和 `hs_is_closed!=true` 可用，API 会解析该值。
5. `--properties` 返回标准嵌套形状：`{"id":"123","properties":{"amount":"5000","dealname":"..."}}`。在 jq 中引用字段为 `.properties.amount`。
6. `dealstage` 中的 stage ID 是 portal-specific；用 `hubspot pipelines stages --type deals --pipeline <id>` 映射它们。
7. `hubspot_owner_id` 是数字字符串；用 `hubspot owners list` 解析为姓名（字段：`id`、`firstName`、`lastName`、`email`）。
8. 每日简报的日期窗口在 macOS 与 GNU `date` 间不同：macOS 用 `TODAY=$(date +%Y-%m-%d); NEXT_7=$(date -v+7d +%Y-%m-%d); YESTERDAY=$(date -v-1d +%Y-%m-%d)`，Linux 用 `TODAY=$(date +%Y-%m-%d); NEXT_7=$(date -d '7 days' +%Y-%m-%d); YESTERDAY=$(date -d '1 day ago' +%Y-%m-%d)`。
9. 查未来 7 天关闭的交易：`hubspot objects search --type deals --filter "closedate>$TODAY AND closedate<$NEXT_7 AND hs_is_closed!=true" --properties dealname,amount,closedate,hubspot_owner_id`。
10. 查过去 24 小时更新过的交易：`hubspot objects search --type deals --filter "hs_lastmodifieddate>$YESTERDAY AND hs_is_closed!=true" --properties dealname,amount,dealstage,hs_lastmodifieddate`。
11. 生成开放管道汇总行：`hubspot objects search --type deals --filter "hs_is_closed!=true" --properties amount | jq -rs '{count: length, value: ([.[].properties.amount | select(. != null) | tonumber] | add // 0 | round)} | "Open pipeline: \(.count) deals, $\(.value)"'`。
12. 按阶段做管道快照（每个 `dealstage` 的数量和金额）：`hubspot objects search --type deals --filter "hs_is_closed!=true" --properties dealstage,amount | jq -rs 'group_by(.properties.dealstage) | map({stage: .[0].properties.dealstage, count: length, total: ([.[].properties.amount | select(. != null) | tonumber] | add // 0 | round)}) | sort_by(-.total) | .[] | "\(.stage)\tcount: \(.count)\tvalue: $\(.total)"' | column -t -s$'\t'`。
13. 按负责人做管道快照：`hubspot objects search --type deals --filter "hs_is_closed!=true" --properties amount,hubspot_owner_id | jq -rs 'group_by(.properties.hubspot_owner_id) | map({owner: .[0].properties.hubspot_owner_id, count: length, total: ([.[].properties.amount | select(. != null) | tonumber] | add // 0 | round)}) | sort_by(-.total) | .[] | "owner \(.owner)\tdeals: \(.count)\tvalue: $\(.total)"' | column -t -s$'\t'`。
14. 给 owner ID 加姓名标签时，先一次性导出 owners 文件并 join：`hubspot owners list | jq -r '"\(.id)\t\(.firstName) \(.lastName) <\(.email)>"' > /tmp/owners.tsv`。
15. 赢单/输单分析过滤：won 用 `hs_is_closed_won=true`；lost 用 `hs_is_closed=true AND hs_is_closed_won!=true`；用 `closedate>=YYYY-MM-DD AND closedate<YYYY-MM-DD` 限定范围。
16. 查某时间段 closed won：`hubspot objects search --type deals --filter "hs_is_closed_won=true AND closedate>=2026-04-01 AND closedate<2026-07-01" --properties dealname,amount,closedate,hubspot_owner_id`。
17. 查某时间段 closed lost：`hubspot objects search --type deals --filter "hs_is_closed=true AND hs_is_closed_won!=true AND closedate>=2026-04-01 AND closedate<2026-07-01" --properties dealname,amount,closedate,hubspot_owner_id`。
18. 按销售代表算赢单率：拉取该时间段所有已关闭交易，按 `hubspot_owner_id` 分组，除以总数；注意 `hs_is_closed_won` 是字符串，所以比较 `== "true"`。命令：`hubspot objects search --type deals --filter "hs_is_closed=true AND closedate>=2026-01-01" --properties hubspot_owner_id,hs_is_closed_won,amount | jq -rs 'group_by(.properties.hubspot_owner_id) | map({owner: .[0].properties.hubspot_owner_id, total: length, won: ([.[] | select(.properties.hs_is_closed_won == "true")] | length), won_value: ([.[] | select(.properties.hs_is_closed_won == "true") | .properties.amount | select(. != null) | tonumber] | add // 0 | round)}) | map(. + {win_rate: ((.won / .total * 100) | round)}) | sort_by(-.won_value) | .[] | "owner \(.owner)\twon: \(.won)/\(.total)\trate: \(.win_rate)%\twon: $\(.won_value)"' | column -t -s$'\t'`。
19. 按关单月份统计收入（won deals）：`hubspot objects search --type deals --filter "hs_is_closed_won=true AND closedate>=2026-01-01" --properties amount,closedate | jq -rs 'group_by(.properties.closedate[0:7]) | map({month: .[0].properties.closedate[0:7], count: length, revenue: ([.[].properties.amount | select(. != null) | tonumber] | add // 0 | round)}) | sort_by(.month) | .[] | "\(.month)\tdeals: \(.count)\trevenue: $\(.revenue)"' | column -t -s$'\t'`。
20. 已知限制：`hubspot pipelines stages` 不暴露 stage probability，因此不能从 stages 列表自动识别 won/lost 阶段；应改用 deals 上的 `hs_is_closed_won`。
21. 已知限制：没有 team object；只能按 `hubspot_owner_id` 分组，并在客户端从 `hubspot owners list` 解析姓名。

适用边界 · 注意事项

• 没有 `hubspot` CLI 或 HubSpot CRM 访问权限时无法使用。
• 不要试图从 `hubspot pipelines stages` 的 stages 列表自动识别 won/lost 阶段或概率，它不暴露 stage probability。
• 不要依赖 team object 做团队级聚合，该系统没有 team object；只能按 `hubspot_owner_id` 分组后在客户端解析姓名。