SKILL.md - SalesClaw v3.0

医药销售业务本体数据库 v3.0（138张表）。

核心理念：用户问题 → NL2SQL → SQL 模板复用 → 归因分析

数据库连接

from db import query_all, query_one
rows = query_all("SELECT * FROM dim_products LIMIT 5")

知识库

路径: ~/.openclaw/workspace/skills/salesclaw/knowledge/

knowledge/
├── index.md                      ← 总索引
├── entities/                     ← 138张表的字段说明（doctors/hospitals/dim_products/...）
├── concepts/                     ← 业务概念（three-layer-attribution / expense-red-green / ...）
└── sql_templates/               ← 沉淀的 SQL 模板（NL2SQL 复用）

SQL 模板（高频问题沉淀）

三层归因模型（归因分析标准方法论）

结构归因（What - 规模维度）

问题：失血发生在哪个结构单元？

分析方向：

• 品种维度：哪个品种贡献主要失血？
• 省区维度：大区 → 省区 → 地区逐层下探
• 时间维度：定位断崖点（哪个月开始下滑）
• 医院层级：一级/二级/三级分层

-- 定位省区处方量贡献（结构归因第一步）
SELECT province,
       SUM(prescription_volume) as vol,
       SUM(prescription_volume) / SUM(SUM(prescription_volume)) OVER () * 100 as share_pct
FROM fct_prescription_flow
WHERE product_id = :product_id
GROUP BY province
ORDER BY vol DESC;

行为归因（Why - 驱动维度）

问题：结构单元的失血是因为什么行为变化？

分析方向：

• 覆盖行为：流向医院数是否下降？
• 拜访行为：代表拜访频次是否下降？
• 竞品行为：竞品是否有学术活动/准入变化？
• 通道行为：医院准入/招标是否有变化？

决策归因（Who - 责任维度）

问题：谁（哪个代表/哪条线）应对变化负责？

分析方向：

• 个人分层：Top/Bottom 代表分层对比达成率
• 分管人责任：区域经理覆盖效率是否达标
• 组织连带：区域负责人是否尽到管理责任

DeltaWeight 计算规范（费用告警标准）

DeltaWeight = 某省区某费用类型占比 - 全国该费用类型占比

省区费用占比 = 该省该费用类型金额 / 该省费用总额
全国费用占比 = 该费用类型金额 / 全国费用总额

诊断会话表（归因推理引擎）

核心关系边（星型拓扑，以 ontology_objects 为中心）

ontology_objects.id（中心节点）
    ↓
    ├── object_links（关系边：代表←→医生、代表←→医院、竞品关系）
    ├── object_events（事件边：拜访、学术活动、处方事件）
    └── time_series_data（时序边：处方量趋势、费用趋势）

工具说明（Tools）

> 使用方式：用户问题 → NL2SQL → 常见问题沉淀为 SQL 模板；复杂推理链路（如三层归因）由工具封装。