用途
本技能用于解答与 Planhat 平台相关的使用与排障问题，覆盖健康分、CRM 同步、收入管理、自动化、终端用户与用量跟踪、指标与报表、REST API、MCP Server、NPS、项目与任务、集成以及管理后台等模块。
主要能力
技能按以下流程工作：
- 收集上下文：若存在 references/learnings.md 会先读取其中积累的平台知识；随后询问用户需要帮助的具体领域（健康分、CRM 同步、收入管理、自动化、终端用户与用量跟踪、指标与报表、REST API、MCP Server、NPS、项目与任务、集成、管理后台），以及正在使用的 CRM（Salesforce、HubSpot、Pipedrive 或无）和 Planhat 套餐（Start-Up、Professional、Enterprise 或不确定）。若用户提问已包含足够上下文，则跳过此步。
- 路由或直接回答：客户成功策略、NPS/CSAT 问卷设计、非 Planhat 专属的 CRM 配置、客户画像数据丰富、CS 平台对比等问题会路由到对应技能（如 /sales-customer-success、/sales-customer-feedback、/sales-integration、/sales-enrich），路由时提供带用户原始问题的完整命令；其余问题直接依据平台参考文档回答。
- 平台参考：读取 references/platform-guide.md 获取模块、定价、集成、数据模型、工作流等完整参考；若涉及 API 端点，再读取 references/planhat-api-reference.md。仅使用相关章节作答，不倾倒整份文档。
- 可操作指导：针对用户具体情境给出建议。健康分问题会梳理指标选择与权重；CRM 同步问题会检查字段映射、同步方向与冲突解决规则；指标问题会检查公式语法与 2-3 小时的构建周期；自动化问题会追踪触发→条件→动作链路。若发现参考文档未覆盖的坑点、变通方法或技巧，会追加到 references/learnings.md。
使用方式
通过 npx skills add sales-skills/sales --skill sales-planhat 安装。相关技能包括 /sales-customer-success、/sales-vitally、/sales-customer-feedback、/sales-integration、/sales-do，各自有对应的安装命令。
适用场景
- 健康分对流失账户显示绿色：审计指标选择，检查数据源（Segment/Mixpanel 产品分析、Zendesk 工单）是否同步，建议加入滞后指标并对照 6-12 个月流失数据验证权重。
- Salesforce 同步产生重复公司：检查外部 ID（Salesforce Account ID）是否作为 keyable/唯一标识正确映射、摄取规则是否匹配正确字段，修复后通过 bulk upsert 去重。
- 自定义指标公式反复失败：检查公式引用的许可/收入字段、日期范围设置，先在单个公司上验证再全量重建，必要时用 API 拉取原始数据校验。
限制与注意事项
- 学习曲线陡峭是首要抱怨，完整搭建建议预留 3-6 周，先从一个模块（健康分或自动化）开始。
- 指标构建需 2-3 小时，公式错误需等待同样时间才能发现，建议先在小数据集上测试并频繁保存。
- CRM 同步可能覆盖字段，双向同步与摄取规则假设数据干净，需为每个字段定义明确的唯一数据源规则。
- 许可摄取假设商机数据干净，需要统一的成交日期、金额与阶段名称。
- API 软限制为 200 次/分钟，硬限制约 150 请求/秒、最多 50 并发；bulk upsert 单次最多 5,000 个对象；analytics.planhat.com 端点有独立且更高的限制。
- 邮件营销为套餐附加功能，需单独购买。
- 收入模型以续约为中心，非续约型业务（按用量、按项目）需要自定义指标变通。
- 报表表格无法对字段求和或拖动列，变通方式为导出 CSV/电子表格或使用数据仓库同步加 BI 工具。
- 上述坑点来自研究，属尽力而为，涉及套餐限制与集成的条目可能已过时，需复核。