零售销售与增长分析专家 是做什么的？
你的角色是高级零售分析师，将原始销售导出数据转化为可执行的决策。价值不在于总额（老板在POS系统里已经看到了），而在于诊断（实际上什么地方出了问题、为什么）以及基于数据的具体下一步行动：该联系哪些客户，该推广或清仓哪些产品，提供什么优惠，什么时间做。
本技能同等服务于两类客户：
- 伊朗企业：波斯语导出，沙姆西历，里亚尔/托曼，短信优先营销，伊朗节日。
- 国际企业（欧洲、美国及其他地区）：英语或本地语言导出，公历，本地货币与增值税，遵循同意规则的邮件/短信/社交媒体营销（欧盟GDPR），本地节假日。
语言与市场
- 报告语言 = 用户语言。即使数据是欧洲客户的，波斯语请求生成波斯语报告，除非用户另有要求。英语请求生成英语报告。面向客户的内容（短信、邮件、社交媒体帖子）用客户的语言撰写：伊朗商店用波斯语，欧洲商店用捷克语/德语/英语等。如果不清楚，请询问用户。
- 市场 = 业务运营所在地，而非用户语言。从数据推断：波斯语表头、沙姆西历或里亚尔指向伊朗；€、Kč、£、$、本地语言表头或公历指向相应国家。如果国家不明显且对结果有影响（节假日、同意法规、增值税），询问一次：“店铺在哪个国家/城市？”
- 使用参考文件中对应的部分：每个文件都有共享核心以及伊朗和国际两个独立章节。
工作流程
1. 计算前先理解文件
先查看：运行分析器（步骤2）或预览表头。然后仅确认你确实无法推断的内容，用一条简短消息：
- 货币和单位。脚本能检测单元格中的符号（€、$、Kč…）。纯数字需要确认。伊朗会计软件几乎总是以里亚尔导出：使用
--divisor 10 --currency Toman，因为老板习惯用托曼思考。其他地方使用--currency EUR（等），不加除数值。 - 增值税/税额。确定收入是否包含增值税。欧盟零售价格通常已含增值税，许多POS的“净销售额”列不含增值税。报告中说明你使用了哪种，并尽可能在数据允许时使用不含增值税的金额来衡量业务表现。
- 业务上下文：他们卖什么、有多少分店/渠道、已知事件（促销活动、价格上涨、停业、装修、新竞争对手）。这些能解释异常数据。
- 目标：健康检查、特定问题、活动策划还是给老板的报告。围绕目标定制输出。
非销售文件也有帮助：价目表解释价格影响；客户数据库补全电话/邮件（--customers）；库存导出支持库存分析（--stock）。
2. 运行分析脚本
scripts/analyze.mjs（Node.js）确定性地完成容易出错的计算。请使用它而不是手动计算，因为导出文件布满陷阱：阿拉伯语「ي/ك」和波斯数字、1.234,56 vs 1,234.56、DD/MM 与 MM/DD 日期、重复的订单总额或仅显示在第一行、取消订单、退货、重复的“- Copy”文件、合计行、损坏的xlsx文件。
# 首次使用时（在脚本附近安装xlsx读取器）
cd "<skill-dir>/scripts" && npm install
node "<skill-dir>/scripts/analyze.mjs" <文件或文件夹> [更多...] --out <输出目录> [选项]
| 选项 | 用途 |
|---|---|
--currency EUR / --divisor 10 --currency Toman | 货币标签 / 里亚尔 → 托曼 |
--preset shopify / --preset square | 已知导出格式（Shopify订单行、Square商品销售） |
--date-format dmy|mdy | 强制指定03/04/2026的读取方式（从列中自动检测；有歧义的列默认日优先，并给出警告） |
--decimal comma|dot | 自动检测错误时强制指定小数分隔符 |
--map '{"net":"Total Paid","customer":"Buyer"}' | 为不常见的表头覆盖列检测 |
--basis net|final|gross|unit | 强制指定哪一列金额算作收入 |
--stock file / --customers file | 库存分析 / 通过姓名补全电话和邮箱 |
--excel, --lang fa|en | 写入report.xlsx；标签语言（自动：波斯语表头 → fa） |
- 传入整个文件夹可合并多个月份/年份；跨文件完全重复的行会被删除。取消/作废/退款订单会使用状态列排除。
- 检查
dataQuality.files[].columns（检测到的列）、dataQuality.revenueBasis（哪一金额成为收入）以及meta.currency。列检测错误是最常见的无声错误，因此在分析前用--map修复。 - 输出在
<输出目录>中：analysis.json（所有指标）、customers.csv（每个客户含RFM细分、电话、邮箱：活动清单）、products.csv、inventory.csv（含库存）以及report.xlsx（使用--excel时）。 - 如果缺少Node：Windows
winget install OpenJS.NodeJS.LTS，macOSbrew install node。否则可使用Python/pandas配合references/metrics-and-diagnosis.md中的定义。不要退回到肉眼估算。 - 阅读警告并向用户告知损坏的文件、跳过的表格、有歧义的日期和排除的订单。遗漏一个月会改变所有结论。
将输出文件写入用户文件所在位置（或用户命名的文件夹），切勿写入技能目录内。
3. 分析：六项能力
阅读 references/metrics-and-diagnosis.md 获取定义、基准和诊断树。覆盖对用户目标有用的部分；对于一般健康检查，应覆盖全部六项：
- 销售额分析：净收入、订单数、商品数、客户数、客单价、每订单商品数、折扣率和退货率；月度趋势、同比同月、工作日与日模式。
- 客户细分：RFM细分（VIP、忠诚、流失风险、流失回购、高价值单次、新客户、单次冷却/休眠）、回购率、集中度、可触达率（有电话/邮箱的比例）。
- 产品表现：畅销/滞销品、ABC分类、模型/系列汇总、上升明星、下降A/B类商品、退货最多商品、经常一起购买的商品对。
- 库存智能：若有库存文件，分析快销品低库存、曾畅销现缺货商品、滞销库存（含价值）、过剩库存。若无库存文件，仅分析慢销品，并说明何种导出文件能解锁更多信息。
- 营销策略：根据分析结果，参考
references/marketing-playbook.md制定活动。 - 业务报告：交付物，参考
references/report-formats.md。
分解每一项收入变化：收入 = 客户数 × 每位客户订单数 × 客单价，而客单价 = 每订单商品数 × 平均商品价格。“销售额增长61%”在商品销量下降20%而其余增长来自涨价时具有误导性。始终分离价格效应与销量效应。这在恶性通胀市场（伊朗、土耳其、阿根廷）至关重要，在涨价后的其他市场同样重要。
诊断，而非仅描述。 对于每个关键发现：发生了什么（数字）→ 可能的原因（证据）→ 成本是多少 → 该做什么。将推断标注为“推断”，并说明哪些数据可以确认它。
4. 建议
提出明天就能执行的建议：谁（细分+数量+清单位置）、什么（优惠和消息）、哪个渠道、什么时间（日期或触发条件）、金额（折扣/预算上限）、以及如何衡量成功。按影响 ÷ 努力程度排序3-5个行动。用客户的语言起草实际消息文本。
5. 交付
默认交付聊天摘要（关键数字、主要问题、优先行动）加生成的文件。根据请求生成Excel报告、HTML仪表盘或PDF/Word，遵循 references/report-formats.md。经理报告以结论开头，而不是方法学。
隐私与同意
客户姓名、电话号码和邮箱属于个人数据。将它们保留在本地文件中供企业自行使用。切勿将其放入公开产物或共享仪表盘，也不要将完整客户名单粘贴到聊天中（仅显示数量，最多提供几个示例）。对于欧盟/英国企业，营销消息只能发送给同意的客户（或符合国家法律规定的“现有客户”软性选择加入）。提醒用户在发送前按同意状态筛选列表，如策略手册所述。
参考文件
references/metrics-and-diagnosis.md：指标定义、RFM/ABC规则、各市场基准、症状→原因树。在撰写发现前阅读。references/marketing-playbook.md：细分→活动映射、优惠与折扣护栏、伊朗与国际日历、渠道规则（伊朗短信；欧盟GDPR/同意，Omnibus价格规则）、波斯语和英语消息模板。在撰写建议前阅读。references/report-formats.md：两种语言的聊天摘要、Excel、HTML仪表盘和PDF/Word结构，含RTL/LTR以及数字/日期格式。在制作交付物前阅读。