导购个人业绩深度分析工具。支持普通门店(POS数据)和AIoT门店(POS+AIoT数据)。 输出导购个人详细诊断报告,包含: 1. 核心业绩指标(销售额、排名、业绩占比) 2. 雷达图能力对比(6维能力 vs 门店平均) 3. 商品特征分析(品类/价格带/包型/颜色/新品偏好) 4. Top5 SKU爆品分析(...
clerk-performance-analysis
对单个导购进行深度业绩分析,支持两种门店类型:
输出导购个人的详细诊断报告,包含业绩指标、商品特征、订单结构、AIoT转化分析等多维度分析。
详见 USAGE.md 获取完整使用指南。
python
import sys
sys.path.insert(0, '~/.openclaw/skills/clerk-performance-analysis')
from analyze import analyze
# 执行分析(Skill自动判断门店类型)
result = analyze(
store_id="416759_1714379448487",
guide_name="李翠",
from_date="2026-03-01",
to_date="2026-03-25"
)
# 查看结果
print(f"销售额: ¥{result['core_metrics']['sales']['amount']:,.0f}")
print(f"排名: #{result['core_metrics']['sales']['rank']}")
text
GET /api/v1/guide/detail?guideName={name}&storeId={id}&fromDate={from}&toDate={to}
返回数据结构:
guideOverallPerformance - 导购整体表现(含排名、雷达图)featureDistribution - 商品特征分布(品类/价格带/包型/颜色/上市日期)skuRanking - SKU销售排行text
GET /api/v1/guide/order-analysis?storeId={id}&fromDate={from}&toDate={to}&guideName={name}
返回数据结构:
OrderDiscounts - 订单折扣分布OrderAttachs - 订单连带分布OrderMembers - 订单会员结构text
GET /api/v1/guide/high-trial-low-conversion?guideName={name}&storeId={id}&fromDate={from}&toDate={to}
返回数据结构:
highTrialLowConversion - 高试用低转化商品列表
goodsName - 商品名称goodsModelCode - 款号trialCount - 试用次数dealCount - 成交件数conversionRate - 转化率standardPrice - 标准价text
GET /api/v1/guide/customer-funnel?guideName={name}&storeId={id}&fromDate={from}&toDate={to}
返回数据结构:
customerFunnel - 客户分层漏斗数据
有效客户 - 有交互行为的客户总数普通客户 - 无试用行为的客户潜在客户 - 有普通试用的客户意向客户 - 有深度试用的客户成交客户 - 有成交的客户环比数据(与上期对比)
6维能力对比(导购 vs 门店平均):
重要说明:
high-trial-low-conversion 返回的是 门店整体 数据,非个人数据。边界情况处理:
情况现象处理方式未佩戴工牌所有客户显示为成交客户正常,提示"未佩戴电子工牌"信息未维护客户漏斗全为0警告"AIoT信息未维护",高试用低转化数据为门店整体
前提条件:
customer-funnel 数据正常(不全为0)分析维度:
触发培训建议:
python
import sys
sys.path.insert(0, '~/.openclaw/skills/clerk-performance-analysis')
from analyze import analyze, batch_analyze
# 分析单个导购
result = analyze(
store_id="416759_1714379448487",
guide_name="李翠",
from_date="2026-03-01",
to_date="2026-03-25"
)
# 批量分析多个导购
results = batch_analyze(
store_id="416759_1714379448487",
guide_names=["李翠", "杨丽", "赵泽瑞"],
from_date="2026-03-01",
to_date="2026-03-25"
)
参数类型必填说明store_idstr是门店IDguide_namestr是导购姓名from_datestr是分析开始日期 (YYYY-MM-DD)to_datestr是分析结束日期 (YYYY-MM-DD)
json
{
"status": "ok",
"store_id": "416759_1714379448487",
"guide_name": "李翠",
"analysis_period": {"from": "2026-03-01", "to": "2026-03-25"},
"core_metrics": {
"sales": {"amount": 64559, "rank": 2, "share": 20.6},
"orders": {"count": 96, "rank": 2},
"atv": {"value": 672.49, "rank": 3},
"attach": {"qty_ratio": 1.48, "sku_ratio": 1.43},
"new_customers": {"count": 29, "rank": 1},
"efficiency": {"value": 3398, "rank": 1, "order_days": 19}
},
"radar_analysis": {
"salesAmount": {"guide": 64559, "store_avg": 43391, "ratio": 1.49, "gap": 21168},
"effectiveOrderCount": {"guide": 96, "store_avg": 70, "ratio": 1.37, "gap": 26},
"newCustomerCount": {"guide": 29, "store_avg": 16, "ratio": 1.81, "gap": 13},
"customerUnitPrice": {"guide": 672, "store_avg": 655, "ratio": 1.03, "gap": 17},
"qtyUnitPrice": {"guide": 455, "store_avg": 450, "ratio": 1.01, "gap": 5},
"attachQtyRatio": {"guide": 1.48, "store_avg": 1.48, "ratio": 1.0, "gap": 0}
},
"feature_analysis": {
"category": {"top": "女包", "top_percentage": 78, "distribution": [...]},
"price_range": {"top": "1000-1200", "top_percentage": 30, "high_price_ratio": 65},
"shape": {"top": "方包", "top_percentage": 30},
"color": {"top": "黑色系", "top_percentage": 37},
"new_items": {"ratio": 30}
},
"sku_analysis": {
"top5_skus": [
{
"rank": 1,
"name": "心遥",
"code": "H51556659",
"sales": 3510.1,
"qty": 3,
"avg_price": 1170.03,
"contribute_rate": 100,
"standard_price": 1299,
"launch_date": "2025/7/1",
"launch_year": 2025,
"launch_month": 7,
"is_new": false,
"months_diff": 8
}
],
"total_skus": 5,
"top5_total_sales": 13161.13,
"top5_total_qty": 12,
"spu_concentration": {
"total_spu": 4,
"spu_list": [
{"name": "心遥", "sku_count": 2, "sales": 5444.12, "qty": 5},
{"name": "舒珀", "sku_count": 1, "sales": 3409.05, "qty": 3}
]
},
"launch_date_analysis": {
"total_items": 5,
"new_items_count": 1,
"new_items_ratio": 20.0,
"launch_dates": [...]
},
"new_items": [
{
"name": "鞣迹",
"code": "H51457102",
"launch_date": "2025/12/1",
"months_diff": 3,
"is_new": true
}
]
},
"order_analysis": {
"discount": {
"main_range": "8-9折",
"main_share": 55.2,
"low_discount_ratio": 27.6,
"total_orders": 98
},
"attach": {
"single_item_ratio": 65.3,
"multi_item_ratio": 12.2,
"avg_attach": 1.50,
"total_orders": 98
},
"member": {
"old_member_ratio": 64.2,
"new_member_ratio": 33.3,
"non_member_ratio": 2.3,
"total_customers": 89
}
},
"aiot_analysis": {
"is_aiot_store": true,
"item_count": 5,
"total_trials": 14,
"items": [
{
"name": "心遥(2)",
"code": "H51757021",
"trial_count": 3,
"deal_count": 0,
"conversion_rate": 0,
"price": 1299
}
]
},
"funnel_analysis": {
"is_aiot_store": true,
"effective_customers": 42,
"deal_customers": 42,
"conversion_rate": 100.0,
"badge_not_worn": true,
"note": "导购未佩戴电子工牌,仅记录成交客户",
"funnel": {
"有效客户": {"value": 42, "percentage": 100, "trend": "down", "link_relative_rate": 28.0},
"普通客户": {"value": 0, "percentage": 0},
"潜在客户": {"value": 0, "percentage": 0},
"意向客户": {"value": 0, "percentage": 0},
"成交客户": {"value": 42, "percentage": 100, "trend": "down", "link_relative_rate": 22.0}
}
},
"findings": [...],
"recommendations": [...]
}
指标字段说明销售额sales.amount销售总额业绩排名sales.rank门店内排名业绩占比sales.share占门店总业绩比例订单数orders.count有效订单数客单价atv.value平均客单价连带率attach.qty_ratio数量连带率新客数new_customers.count新增会员数人效值efficiency.value日均业绩贡献有订单天数efficiency.order_days统计周期内有成交的天数
指标说明ratio导购值 / 门店平均值,>1表示优于平均gap导购与门店平均的绝对差距
指标说明top占比最高的品类/价格带/包型/颜色top_percentage占比百分比high_price_ratio800元以上商品销售占比new_items.ratio2026年新品销售占比
指标字段说明主销折扣order_analysis.discount.main_range占比最高的折扣区间低折扣占比order_analysis.discount.low_discount_ratio6折以下订单占比1件单占比order_analysis.attach.single_item_ratio单件订单占比多连带占比order_analysis.attach.multi_item_ratio≥3件订单占比平均连带order_analysis.attach.avg_attach平均连带件数老会员占比order_analysis.member.old_member_ratio老会员销售占比新会员占比order_analysis.member.new_member_ratio新会员销售占比
指标字段说明是否AIoT门店aiot_analysis.is_aiot_store是否有AIoT数据高试用低转化商品数aiot_analysis.item_count试用>0但成交=0的商品数总试用次数aiot_analysis.total_trials这些商品的总试用次数商品名称aiot_analysis.items[].name高试用低转化商品名称试用次数aiot_analysis.items[].trial_count该商品被试用次数成交件数aiot_analysis.items[].deal_count该商品成交件数转化率aiot_analysis.items[].conversion_rate试用转化率
问题判断条件严重程度业绩排名靠后排名 > 3🟡 中新客获取能力不足新客数 < 门店平均70%🟡 中新客获取能力突出新客数 > 门店平均150%🟢 低(优势)客单价偏低客单价 < 门店平均85%🟡 中品类过于集中单一品类占比 > 70%🟡 中高客单销售弱800元以上占比 < 30%🟡 中连带销售能力不足1件单占比 > 60%🟡 中低折扣订单占比过高6折以下订单 > 20%🟡 中导购AIoT信息未维护****客户漏斗全为0🟡 中(仅AIoT)高试用低转化商品多**≥3个高试用低转化商品🟡 中(仅AIoT)新品试用转化差****高试用低转化中新品≥2个🟡 中(仅AIoT)有效客户大幅下降环比下降>20%**🔴 高(仅AIoT)**无销售天数过多14天中≥5天无销售🟡 中日均销售额偏低****日均<¥1000**🟡 中
核心业绩:
雷达图对比:
商品特征:
订单结构:
爆品分析(Top5 SKU):
排名款号名称销量销售额均价门店贡献率上市时间新品#1H51556659心遥3件¥3,510¥1,170100%2025/7#2H51456675舒珀3件¥3,409¥1,136100%2025/7#3H51457102鞣迹2件¥2,174¥1,08769%2025/12✓#4H60101090爱旅2件¥2,134¥1,067100%2025/7#5H51556656心遥2件¥1,934¥96734%2025/7
Top5合计: 销量12件, 销售额¥13,161(占总业绩20.4%)
门店贡献率 = 导购该SKU销售额 / 门店该SKU总销售额
SPU集中度:
上市时间偏好:
AIoT高试用低转化分析(仅AIoT门店):
AIoT客户漏斗分析(仅AIoT门店):
诊断发现:
行动建议:
v3.1.0 - 导购个人业绩深度分析(新增销售额Top5与高试用低转化Top5对比分析)