技能介绍

解决什么问题

销售复盘最难受的不是没有数据，而是数据看起来都有、拼出来的结论却对不上。销售易连接器在抓取四类实体时存在三处会静默返回错误数据的坑：多查询模式把 activityrecord 截断为最新 16 条、请求带 dataView 时 opportunity 返回 0 条、用聚合接口做单人拆分会忽略 ownerId 并返回全租户数据。更麻烦的是团队复盘口径：每个销售各自拉一遍，跟进时间窗、客户状态分类、撞单判断都不一致，同一份报告两个人跑出两个结果。这个技能的目标是让任何人用同样一组参数复现同一份全景复盘，从源头堵住这三处坑。

核心能力

多维切片与统一抓取。 参数全部可选：owners 支持单个销售、subordinates 自动发现下属或显式 userId 列表；period 同时过滤跟进日期和商机 closeDate；customer_type 按 industry、level、标签过滤客户；account_ids 只看指定客户；compare 传入第二个时间段做前后对比。单人场景就是 owner 集合只有一人的退化情况，流程完全复用。

固化的执行链路。 先解析 owner 集合，再逐 owner 单实体分页调用 mcp__neo-crm__entity-search：account、contact、opportunity、activityrecord 一律用 ownerId 条件，不加 dataView；跟进记录读取 total 继续翻页直到取全。切片过滤后，单人管道只走 mcp__neo-crm__crm-myPipelineSummary，拿到 healthScore、加权预测和漏斗各阶段数量。指标计算覆盖五维复盘（过程行为、商机管道、结果目标、一把手触达、能力成长）、客户状态六分类（已赢单、商机推进中、高意向未建单、跟进中、零跟进沉睡、撞单风险）以及跟进趋势和热点客户 TOP。最后由 scripts/build_report.py 读取标准化 JSON 渲染响应式 HTML，部署为 CloudStudio 外链交付。

适用边界与注意点

前提是 neo-crm 连接器已 connected；未连接时先连接再执行，不要在接口不可用时猜测 ownerId。
activityrecord 超过 50 条必须翻页；单人管道不要用 entity-aggregate 或 entity-query 拆分，否则会拿到全租户数据。
字段名以实际返回为准，references/data-schema.md 只列常见映射，缺失字段按尽力而为处理。
金额单位以 CRM 返回为准（实测为元），报告内统一标注 ¥。
撞单判断分两种：多 owner 时跨人同 account 直接高亮，单 owner 场景只标注需后台核实的疑似撞单。
报告默认是外链交付形态，发布后需在「设置 - 数据管理 - 我发布的应用」里管理或删除。