# Starrocks Business Analysis Sly

> 该技能用于通过 MCP 查询餐饮企业门店经营数据，涵盖门店画像、营收客流、优惠结算、菜品套餐、渠道来源、员工绩效、运营效率、会员分析、供应链进销存等多维分析，支持跨品牌跨区域对比。典型场景：查门店列表/营收排名/客单价/翻台率/优惠占比/套餐占比/小程序渠道/服务员排名/环比同比/会员消费排行/复购留存/积分流转/优惠券核销/RFM分层/采购分析/耗用分差/毛利/进销存/盘点差异等。

- Skill: `infometa/starrocks-business-analysis-sly` (Agent Skill, multi-file: 25 files)
- Install (CLI): `npx skillmds@latest add infometa/starrocks-business-analysis-sly`
- Raw SKILL.md: https://api.skillmd.com/api/skills/infometa/starrocks-business-analysis-sly/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: infometa (https://skillmd.com/u/infometa)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/infometa/starrocks-business-analysis-sly

---


# starrocks-business-analysis-sly

## 快速导航

| 模块 | 文件 | 说明 |
|------|------|------|
| Intent 速查 | [intents/_index.md](intents/_index.md) | 78 个 Intent 一览表（编号 1-50、76-103，其中 51-75 保留） |
| **🏪 门店画像**（Intent 1-5） | [intent-01-store-profile.md](intents/intent-01-store-profile.md) | 门店列表、地理分布、品牌排名、管理类型、规模 |
| **💰 营收分析**（Intent 6-9） | [intent-02-revenue.md](intents/intent-02-revenue.md) | 营收趋势、门店排名、品项原价、坪效 |
| **👥 客流与客群**（Intent 10-14） | [intent-03-customer-flow.md](intents/intent-03-customer-flow.md) | 销售渠道、场景、来源、客群、翻台率、续单 |
| **🎁 优惠与结算**（Intent 15-19） | [intent-04-discount.md](intents/intent-04-discount.md) | 优惠折扣、服务费、押金、签单、发票 |
| **🍽️ 菜品与套餐**（Intent 20-22） | [intent-05-dishes.md](intents/intent-05-dishes.md) | 套餐、会员、退菜分析（账单层） |
| **📱 渠道与来源**（Intent 23-24） | [intent-06-channel.md](intents/intent-06-channel.md) | 小程序渠道、订单类型 |
| **👨‍🍳 员工绩效**（Intent 25-27） | [intent-07-staff-performance.md](intents/intent-07-staff-performance.md) | 服务员、收银员、业务员绩效 |
| **⏱️ 运营效率**（Intent 28-32） | [intent-08-efficiency.md](intents/intent-08-efficiency.md) | 时段、天气、出品、用餐时长、评分 |
| **📊 多维对比**（Intent 33-41） | [intent-09-multi-dimension.md](intents/intent-09-multi-dimension.md) | 环比、同比、跨维度、直营加盟、区域品牌、桌区 |
| **🥩 菜品明细分析**（Intent 42-50） | [intent-10-item-analysis.md](intents/intent-10-item-analysis.md) | 菜品排行、大类占比、套餐、毛利、退菜、渠道品项、赠送分析 |
| **🏅 会员分析**（Intent 76-94） | [intent-11-member.md](intents/intent-11-member.md) | 会员概况、消费排行、复购留存、充值积分、优惠券、价值分层 |
| **💳 会员卡型分析**（Intent 95-97） | [intent-11-member.md](intents/intent-11-member.md) | 卡型分布、跨品牌多卡、余额分布/沉睡资金 |
| **📦 供应链原物料**（Intent 98-103） | [intent-12-scm.md](intents/intent-12-scm.md) | 采购分析、耗用分差、毛利、进销存、盘点差异、趋势 |
| 安全规则 | [rules/security-rules.md](rules/security-rules.md) | 权限检查清单 |
| 输出规范 | [rules/output-format.md](rules/output-format.md) | 输出格式标准 |
| Intent 未命中 | [rules/intent-fallback.md](rules/intent-fallback.md) | 5级降级处理 |
| **参数缺失补全** | [rules/param-fallback.md](rules/param-fallback.md) | `#{变量名}` 占位符按需预查询补全与失败处理 |
| **🏪 门店编码获取 CLI** | [rules/param-fallback.md](rules/param-fallback.md#八门店编码获取-cli用户指定门店时使用) | `sl store find` 名称 → omShopCode 解析 |
| 表结构 | [references/table-schema.md](references/table-schema.md) | 数据表速查 |

---

## 用途

当用户提出以下需求时启用本技能：

| 分类 | 业务说明 | 典型问题 |
|------|----------|----------|
| 🏪 门店画像 | 静态基础信息 | 有多少门店、在哪、什么品牌 |
| 💰 营收分析 | 收入核心指标 | 营收多少、最赚钱是哪家 |
| 👥 客流与客群 | 人从哪来、多少人 | 外卖占比、客单价、翻台率 |
| 🎁 优惠与结算 | 省多少钱、怎么结账 | 优惠多少、押金、签单、发票 |
| 🍽️ 菜品与套餐 | 卖什么、点什么 | 套餐占比、会员消费、退菜分析 |
| 📱 渠道与来源 | 线上还是线下 | 小程序占比、订单类型 |
| 👨‍🍳 员工绩效 | 谁干得好 | 服务员/收银员/业务员排名 |
| ⏱️ 运营效率 | 快不快、好不好 | 用餐时长、出品速度、评分 |
| 📊 多维对比 | 交叉、趋势、对比 | 环比同比、区域品牌对比 |
| 🥩 菜品明细分析 | 品项销售/毛利/退菜/渠道 | 畅销菜、毛利率、套餐排行、退菜品项 |
| 🏅 会员分析 | 会员消费/充值/积分/优惠券 | 高价值会员、复购率、留存率、积分流转、优惠券核销、价值分层 |
| 💳 会员卡型 | 卡型结构/多卡会员/余额分布 | 卡型占比、跨品牌多卡、储值余额、积分沉淀、沉睡资金 |
| 📦 供应链原物料 | 库存/采购/耗用/毛利 | 库存现状、采购占销比、耗用分差、毛利率、进销存、盘点差异、周转天数 |

---

## ⚠️ 执行前必读（AI 行为约束）

### 🔐 权限机制

> 🔐 **插值机制**：在 SQL 语句中使用 `#{变量名}` 占位符，系统会在执行前自动将变量值插入 SQL 中。**所有 7 张业务表统一使用一套编码**：

| 变量名 | 对应表.字段 | 说明 | 示例值 |
|--------|------------|------|--------|
| `#{SL_UNIFIED_G_ID}` | `group_code`（**所有 7 张表统一**） | 集团 G 号（商龙云统一集团编码） | `G137427` |
| `#{omShopCodes}` | `store_code`（**所有 7 张表统一**） | 门店 C 号（商龙云统一门店编码列表，逗号分隔） | `'C273353','C273354',...` |
| `#{omShopCodeOrgNameMap}` | — | 门店码→门店名映射（辅助信息） | `{"C273353":"张福记陇海店",...}` |

**SQL 占位符写法示例**：

```sql
-- ✅ 正确：用 #{变量名} 占位符，由系统自动插入
WHERE group_code = '#{SL_UNIFIED_G_ID}'                       -- 单值占位符
  AND store_code IN (#{omShopCodes})                      -- 多值列表占位符（字面插入）

-- ❌ 错误：硬编码具体值（绝对禁止）
WHERE group_code = 'G137427'                              -- 禁止硬编码集团码
  AND store_code IN ('C273353', 'C273354', 'C273355')     -- 禁止硬编码门店码
```

**关键约束**：
- **AI 永不接触真实值**：SQL 模板中只出现 `#{变量名}`，真实 G 号 / 门店列表由系统注入，AI 不在对话或代码中暴露具体值
- **变量来源**：`#{SL_UNIFIED_G_ID}` / `#{omShopCodes}` / `#{omShopCodeOrgNameMap}` 的真实值由机器人配置层（典型实现如 `token.json` 的 `biz_params` 字段）提供，AI **不接触**真实值
- **跨集团零容忍**：禁止试图查询配置外的集团 / 门店，若用户要求越权查询应直接拒绝

> ✅ **统一编码原则**：7 张表（`e000.dt_store_view` / `dm.v_pos_corp_sale_analysis_with_sly` / `dm.v_item_sale_analysis_with_sly` / `dm.dm_crm_card_sum_day_p_store` / `dm.v_crm_member_with_sly` / `dw.dwd_crm_member_card_p_with_sly` / `dm.dm_ljc_scm8_store_rm_item_consume_analysis_day_p_group_view`）均含 `group_code` + `store_code` 字段，且分别代表**集团 G 号**和**门店 C 号**。**所有表可直接通过 `group_code` + `store_code` 关联**，无需任何多码映射。
>
> 💡 `e000.dt_store_view` 同时保留 `cy_store_code`（餐饮门店编号）和 `cy_group_code`（餐饮集团编号），仅作为历史/对账用途，业务查询统一使用 `group_code` + `store_code`。

### 🔐 安全规则

> 详见 [rules/security-rules.md](rules/security-rules.md)

核心约束速览：

| 约束项 | 要求 |
|--------|------|
| **单轮查询上限** | 每轮最多执行 **10 次** `sl starrocks read-query`，超限立即停止并报告；命中 Intent 且槽位齐全时目标 ≤ **2** 次（含可选轻量探活） |
| **空结果分类** | 类型 A（参数构造问题）允许修正后重试 **1 次**；类型 B（数据不存在）**强制停止** |
| **MCP 探活** | **禁止**会话初全表 `COUNT(*)`；正常首问直接业务 SQL。仅当首条业务 SQL 报连接/表不存在类错误时，再跑带 `group_code`+`store_code`+近 30 天日期的 `SELECT 1 ... LIMIT 1`；POS 探活无行**不**判 MCP 空库 |
| **group_code 强制注入** | **所有 SQL 的 WHERE 条件中必须包含 `group_code` 过滤**，具体值由机器人配置层通过 `#{SL_UNIFIED_G_ID}` 占位符注入，AI 不得省略、不得硬编码、不得跨集团查询 |
| **group_code / store_code 值范围强制校验** ⚠️ | SQL 中出现的 `group_code` / `store_code` 值**必须 100% 来自 `#{SL_UNIFIED_G_ID}` / `#{omShopCodes}` 占位符的注入值**，AI 不得私自添加、枚举、或推断任何不在占位符范围内的值（含硬编码、额外 OR 条件、子查询返回非授权值） |
| **store_code 始终启用** | 所有 SQL 的 WHERE 中**必须**包含 `store_code IN (#{omShopCodes})`（无例外）；`#{omShopCodes}` 的值分两种场景：① 用户未指定门店 → 取 token 默认全部门店码列表；② 用户明确指定门店 → 先 `sl store find` 获取 `omShopCode`，更新 `#{omShopCodes}` 值后再执行 SQL |
| **禁止跨集团搜索** | 只能查当前 token 中的 group_code，禁止越权 |
| **禁止无日期范围查询** | 营业表必须指定 `settle_biz_date` 范围，否则拒绝执行 |
| **禁止无 LIMIT 查询** | 营业表查询必须带 LIMIT，防止全表扫描 |

> 💡 空结果标准回复模板、MCP 异常回复模板、类型 A/B 完整规则 → 详见 [rules/security-rules.md](rules/security-rules.md)

### 🔗 编码预查规则（按需补全策略）

> 💡 `#{SL_UNIFIED_G_ID}` / `#{omShopCodes}` 占位符的真实值通常由机器人配置层（典型实现如 `token.json` 的 `biz_params` 字段）提供，**优先直接使用**。  
> 正常运行时 `#{omShopCodes}` 始终由系统注入；仅在配置异常导致其缺失或为空时，才按以下规则尝试预查补全。补全失败时必须停止并提示修复配置，**不得**省略 `store_code IN (#{omShopCodes})` 执行集团级查询。

#### 按需预查补全规则

| 缺失参数 | 必填前置参数 | 补全 SQL（简化版） | 失败处理 |
|---------|------------|-----------------|--------------|
| `omShopCodes` | 有 `#{SL_UNIFIED_G_ID}` | `SELECT CONCAT("'", GROUP_CONCAT(DISTINCT store_code SEPARATOR "','"), "'") FROM dm.v_pos_corp_sale_analysis_with_sly WHERE group_code = '#{SL_UNIFIED_G_ID}' AND settle_biz_date >= DATE_SUB(CURDATE(), INTERVAL 30 DAY) LIMIT 1` | 🛑 停止执行，提示用户修复 `omShopCodes` 门店权限配置；不得去掉 `store_code` 过滤 |
| `SL_UNIFIED_G_ID` | 无前置可用 | — | ⚠️ 拒绝执行，提示用户配置 `SL_UNIFIED_G_ID` 后再查询 |

> ⚠️ **POS 视图 40 亿行**，预查必须带 **近 30 天日期窗口**（`settle_biz_date >= DATE_SUB(CURDATE(), INTERVAL 30 DAY)`），否则超时。

#### 最低门槛检查（核心参数全缺时）

若 `SL_UNIFIED_G_ID` 缺失或为空：

> ⚠️ 当前账号未配置集团编码权限，无法执行数据查询。请联系管理员在机器人配置中添加 `SL_UNIFIED_G_ID` 参数。

> 💡 详细补全逻辑与降级行为 → [rules/param-fallback.md](rules/param-fallback.md)

### 🏪 门店编码获取 CLI（用户指定门店时必走）

> 🎯 **触发条件**：用户输入中**明确出现**门店名称 / 简称 / 别名 / 门店 ID 时，必须先调用 `sl store find` 获取标准 `omShopCode`，再用于 SQL 拼接。
> **不触发**：用户问"集团/全部门店"等无具体门店指向的查询时跳过此步，直接用 token 默认权限。

#### 命令格式

> 路径见「CLI 入口」；Bash 下一键兼容：

```bash
SL="$HOME/.slclaw/bin/sl"; [ -f "$HOME/.slclaw/bin/sl.cmd" ] && SL="$HOME/.slclaw/bin/sl.cmd"

# 按名称查询
"$SL" store find --type crm --name "<门店关键词>" --format json

# 按关键词 / 门店 ID 混合查询
"$SL" store find --type crm --keyword "<门店关键词或门店ID>" --format json
```

#### 返回结果判定规则

CLI 返回 **门店候选 JSON 数组**，每条候选含：

| 字段 | 用途 |
|------|------|
| `omShopCode` | **后续 `omShopCodes` 参数的取值**（门店 C 号） |
| `orgName` | 向用户展示的门店名称（消歧用） |

| 命中数 | AI 行为 |
|--------|--------|
| 0 条（空数组） | 🛑 停止，提示「未找到匹配门店」 |
| 1 条 | ✅ 直接使用该 `omShopCode`，无需确认 |
| ≥ 2 条 | ⚠️ **列表展示让用户确认**，**禁止静默选第一条** |

#### Token 缺门店清单降级

CLI 提示 token 缺门店清单（如 `token missing store list`）时：

1. 先执行 `sl token refresh dc` 刷新门店权限
2. **重试一次**同一条 `sl store find`
3. 仍失败 → 按"未找到门店"模板告知用户

> 💡 完整 CLI 说明、消歧模板、流程图、与 SQL 预查补全的对比 → [rules/param-fallback.md#八门店编码获取-cli用户指定门店时使用](rules/param-fallback.md#八门店编码获取-cli用户指定门店时使用)

### 🔒 安全规则（违反则拒绝执行）

| 检查项 | 要求 | 违规处理 |
|--------|------|----------|
| **group_code 强制过滤** | 所有 SQL 的 WHERE 必须含 `group_code`，值由配置层注入 | 拒绝执行，补全后重试 |
| **store_code 归属** | 只能查询机器人配置层配置的门店 | 过滤无效门店，拒绝越权查询 |
| **禁止跨集团搜索** | 安全要求（C5-02） | 拒绝执行，提示权限不足 |
| **禁止暴露其他集团** | 安全要求（C5-01） | 拒绝执行，提示权限不足 |
| **日期范围** | 用户必须指定起止日期 | 未指定则询问，拒绝全量查询 |
| **LIMIT 上限** | 强制要求防止全表扫描 | 拒绝无上限查询 |

> 💡 详细检查逻辑 → [rules/security-rules.md](rules/security-rules.md)

### 📋 输出规范（每次查询必须执行）

| 规范项 | 要求 |
|--------|------|
| **数据范围说明** | **必须**在结果末尾附上（见下方模板） |
| **输出格式** | **必须**使用 output-format.md 中的标准格式 |
| **信息安全** | **禁止**在结果中暴露 SQL 参数或内部实现 |

#### 数据范围说明模板（每次必须附加）

```
---
📊 数据范围：{start_date} ~ {end_date} | 【集团名称】
💡 提示：数据为 T-1 日结，今日实时数据暂不可用
💡 仅显示您权限范围内的数据
```

---

## 极简执行路径（积分优先）

> ⚡ **首问默认走本路径。** WorkBuddy 积分按轮次/工具调用计费；禁止探索性绕路。

对「已命中 Intent 且槽位齐全」的问法，强制：

1. 用「CLI 入口」的 **Bash 一键兼容** 调用（自动选 Windows `sl.cmd` / macOS `sl`），**禁止** `which` / `where` / Bash 内 `%USERPROFILE%\...`
2. 只打开 [`intents/_index.md`](intents/_index.md) → **对应 1 个** intent 文件（禁止扫全部分类文档）
3. 套模板拼 **1 条** SQL（含 `group_code` / `store_code` / 日期 / LIMIT）
4. 用上述绝对路径执行 **1 次** `starrocks read-query`（优先 Bash，勿先绕 PowerShell）
5. 单轮目标：业务查询 ≤ **2** 次 CLI（第 2 次仅用于类型 A 修正重试，或连接失败后的轻量探活）

**明确禁止**：找 path、Bash 写 `%USERPROFILE%\...`、未命中前通读全部 intent、会话初全表 `COUNT(*)`、用 Python/Node 脚本转发查询。

---

## 执行流程

```
路径固定（Bash 一键兼容绝对路径，禁止 which/where / 禁止 %USERPROFILE%\...）
    ↓
用户输入
    ↓
1️⃣ 识别 Intent & 提取 Slot（只读 _index → 1 个 intent 文件）
    ↓
1.5️⃣ 门店识别（**用户明确指定门店名称/简称/别名/门店 ID 时必走**）
    → 调用 `sl store find` 把门店名 → omShopCode
    → 0 候选：停止并提示
    → 1 候选：直接使用，**更新** `#{omShopCodes}` 值为该门店码
    → ≥2 候选：列表让用户确认（禁止静默选第一条），**更新** `#{omShopCodes}` 值为用户确认的门店码
    → token 缺清单：先 `sl token refresh dc` 再重试一次
    → 用户未指定门店：跳过此步，`#{omShopCodes}` 保持 token 默认全部门店码
    ↓
2️⃣ 日期范围检查（仅营业表，未指定则询问）
    ↓
3️⃣ 参数按需补全检查（仅占位符缺失时）
    → 构建 SQL 前检查当前 Intent 所需 `#{变量名}` 是否可用
    → 若缺失：执行对应预查 SQL 补全（见「🔗 编码预查规则」章节）
    → 补全失败：停止执行并按 `rules/param-fallback.md` 提示用户修复配置；不得去掉 `store_code` 过滤
    ↓
4️⃣ 构建 SQL → 直接执行业务查询（正常首问不做全表健康检查）
    → ⚠️ WHERE 条件中必须包含 `group_code = '#{SL_UNIFIED_G_ID}'` AND `store_code IN (#{omShopCodes})`（两条均无条件始终启用）
    → ⚠️ **值范围校验（C3-05）**：SQL 中出现的 group_code / store_code 值必须 100% 来自 #{SL_UNIFIED_G_ID} / #{omShopCodes} 占位符
    ↓
5️⃣ 若业务 SQL 报连接/表不存在 → 轻量探活（见 security-rules）；POS 无行不判 MCP 空库
    ↓
6️⃣ 展示结果 & 简要建议
```

> 💡 `#{变量名}` 选用规则详见「🔐 权限机制」章节。核心原则：**所有 7 张表统一使用 `#{SL_UNIFIED_G_ID}`（→ `group_code`）+`#{omShopCodes}`（→ `store_code`）**。

---

## 表结构

| 表名 | 用途 | 数据量 |
|------|------|--------|
| `e000.dt_store_view` | 门店主数据 | 268,125 家 |
| `dm.v_pos_corp_sale_analysis_with_sly` | 营业明细（视图） | 40亿+ 条 |
| `dm.v_item_sale_analysis_with_sly` | 菜品销售（视图） | 2.7亿 条 |
| `dm.dm_crm_card_sum_day_p_store` | 会员每日汇总（新表） | 1.4亿 条 |
| `dm.v_crm_member_with_sly` | 会员维表（视图） | 17.4亿 会员 |
| `dw.dwd_crm_member_card_p_with_sly` | 会员卡明细表 | 17.7亿 卡 |
| `dm.dm_ljc_scm8_store_rm_item_consume_analysis_day_p_group_view` | SCM8 原物料耗用视图 | 2.6亿 行 |

### ⚠️ 会员日汇总表门店字段说明

> 📌 **默认取数口径**：统计消费、储值、积分、用券等数据时，**默认取交易门店的数据**。

| 字段 | 含义 | 用途 |
|------|------|------|
| `store_code` | **交易门店**的商龙云门店号 | ✅ **默认取此字段** |
| `saled_shop_code` | 会员卡**售卡**云端门店号 | 需用户明确要求时使用 |
| `o2o_store_code` | 交易**云端**门店号 | 需用户明确要求时使用 |
| `mem_store_code` | 会员**注册**门店 | 需用户明确要求时使用 |

> 💡 如需按"注册门店"或"售卡门店"统计，需主动询问用户并调整查询条件。

### 🔗 七表关联关系

> ✅ **所有 7 张表的 `group_code`（集团 G 号） + `store_code`（门店 C 号）字段含义完全一致，可直接 JOIN。**

```
e000.dt_store_view（门店主数据，仅含 4 字段：store_code / group_code / cy_store_code / cy_group_code）
│
│  JOIN on group_code + store_code
│
├──→ dm.v_pos_corp_sale_analysis_with_sly（POS 营业明细）
├──→ dm.v_item_sale_analysis_with_sly（菜品销售）
├──→ dm.dm_crm_card_sum_day_p_store（会员日汇总）
├──→ dm.v_crm_member_with_sly（会员维表）
├──→ dw.dwd_crm_member_card_p_with_sly（会员卡明细）
└──→ dm.dm_ljc_scm8_store_rm_item_consume_analysis_day_p_group_view（SCM8 原物料耗用）

会员体系内部关联：
dm_crm_card_sum_day_p_store ←── group_code + store_code + mem_code ──→ v_crm_member_with_sly
dm_crm_card_sum_day_p_store ←── group_code + store_code + mem_card_no ──→ dwd_crm_member_card_p_with_sly.card_no
```

> 💡 详细字段 → [references/table-schema.md](references/table-schema.md)

---

## CLI 入口

### 🔧 CLI 可执行路径（强制 · Windows / macOS 兼容）

> WorkBuddy / Agent 执行环境通常 **没有** 把 `~/.slclaw/bin` 加入 PATH。
> 下文所有 `sl ...` 均指 `$HOME/.slclaw/bin` 下的绝对路径，**禁止**先 `which` / `where` / 搜索安装目录。
>
> ⚠️ WorkBuddy 在 Windows 上默认走 **PortableGit Bash**，不是 `cmd.exe`。`%USERPROFILE%\...` 与反斜杠路径会在 Bash 里触发 `fg: no job control` 等失败。

| 平台 | 可执行文件 | 说明 |
|------|------------|------|
| macOS / Linux | `$HOME/.slclaw/bin/sl` | POSIX 入口 |
| Windows（Bash / WorkBuddy） | `$HOME/.slclaw/bin/sl.cmd` | **必须**用 `.cmd`；裸 `sl` shebang 在 PortableGit 下常 exit 126 |
| Windows（PowerShell 备用） | `$env:USERPROFILE\.slclaw\bin\sl.cmd` | 仅 Bash 不可用时使用 |

#### ✅ 首选：Bash 一键兼容（Mac / Linux / Windows Git Bash）

> 优先用 **Bash** 工具执行；一行内自动选 `sl.cmd`（Windows）或 `sl`（Mac/Linux）。

```bash
SL="$HOME/.slclaw/bin/sl"; [ -f "$HOME/.slclaw/bin/sl.cmd" ] && SL="$HOME/.slclaw/bin/sl.cmd"; "$SL" starrocks read-query --query 'SELECT 1'
```

业务查询把末尾换成真实 SQL 即可，例如：

```bash
SL="$HOME/.slclaw/bin/sl"; [ -f "$HOME/.slclaw/bin/sl.cmd" ] && SL="$HOME/.slclaw/bin/sl.cmd"; "$SL" starrocks read-query --query "SELECT 1"
```

| 命令形态 | 用途 |
|----------|------|
| `"$SL" starrocks read-query --query '...'` | 执行单个只读查询 |
| `"$SL" store find --type crm --name '...' --format json` | 门店名 → omShopCode |

#### Windows PowerShell 备用（仅 Bash 不可用时）

```powershell
& "$env:USERPROFILE\.slclaw\bin\sl.cmd" starrocks read-query --query 'SELECT 1'
```

> 必须让 stdout **直接打印**到工具结果。禁止只写 `$output = & ...` 却不 `Write-Output $output`（WorkBuddy 可能只回报 exit code、看不到 JSON）。

#### ❌ 禁止（已实测踩坑）

| 写法 | 问题 |
|------|------|
| Bash 里用 `%USERPROFILE%\.slclaw\bin\sl.cmd` | cmd 变量/反斜杠在 Bash 不展开 → `fg: no job control` |
| Windows Bash 直接跑 `$HOME/.slclaw/bin/sl`（无 `.cmd`） | PortableGit 下 node shebang 常失败（exit 126） |
| 依赖 PATH / `which` / `where` / 搜索安装目录 | 环境无 PATH，浪费轮次 |
| Python / Node 脚本转发查询 | 禁止；统一直接调绝对路径 CLI |

### 🔧 CLI 配置说明

> ⚠️ **MCP 地址不在 skill 中硬编码**，而是由 `sl starrocks` 在运行时自动读取配置。

当前 CLI 仅支持 `read-query --query`。多步骤分析需在单轮 10 次上限内逐条调用上述绝对路径下的 `sl starrocks read-query --query ...`。

**禁止**使用 Python、Node/JS 脚本或其他中间脚本转发查询。

---

## 核心概念

### 三个金额指标

| 指标 | 字段 | 关系 |
|------|------|------|
| 营业应收 | `recv_money` | 最大，未减优惠 |
| 实收金额 | `busi_income` | 次高，扣除优惠 |
| 纯收金额 | `real_income` | 最小，再减杂项 |

> 💡 详细说明 → [references/business-context.md](references/business-context.md)

### 翻台率计算

| 指标 | 公式 |
|------|------|
| 开台率 | 总开台数 ÷ Σ(每天桌数 × 当天市别数) × 100% |
| 翻台率 | 开台率 - 1（若 < 0 则显示 0） |

> 💡 详细说明 → [references/business-context.md](references/business-context.md)

---

## 📝 文档维护说明

### 路径引用规则

| 引用场景 | 相对路径格式 | 示例 |
|---------|-------------|------|
| 同级目录引用 | `filename.md` | `intents/_index.md` → `intent-01-05-store.md` |
| 上级目录引用 | `../folder/file.md` | `intents/_index.md` → `../rules/security-rules.md` |
| 锚点链接 | `#anchor-name` | `intent-06-15-business.md#intent-6-revenuetrendanalysis---营收趋势分析` |

### Intent 维护规则

1. **新增/修改 Intent** 时，必须同步更新：
   - `intents/_index.md` 的「Intent 详细索引」
   - `intents/_index.md` 的「快速匹配指南」
2. **新增 Intent 文件** 时，需在 `_index.md` 添加对应链接
3. **锚点命名规范**：`intent-{序号}-{小写驼峰名称}--{中文说明}`

### 内容引用原则

| 概念 | 权威来源 | 其他文件引用方式 |
|------|---------|----------------|
| 三个金额指标 | `references/business-context.md` | 仅摘要，标注「详见...」 |
| 翻台率计算 | `references/business-context.md` | 仅公式，标注「详见...」 |
| 表结构字段 | `references/table-schema.md` | 标注「详见...」 |
| 安全规则 | `rules/security-rules.md` | SKILL.md 仅放摘要表格 |

### 禁止事项

- ❌ 禁止在多个文件重复完整的业务概念解释
- ❌ 禁止删除 `rules/security-rules.md` 中的任何安全检查项
- ❌ 禁止绕过机器人权限配置查询范围外的数据
- ❌ 禁止 SQL WHERE 条件中省略 `group_code` 过滤（必须由配置层注入）
- ❌ 禁止在 SQL 中硬编码 `group_code` / `store_code` 具体值（使用 `#{SL_UNIFIED_G_ID}` / `#{omShopCodes}` 占位符）
- ❌ 禁止在 SQL 中私自添加、枚举、或推断任何不在 `#{SL_UNIFIED_G_ID}` / `#{omShopCodes}` 占位符范围内的值（含额外 OR 条件、额外 IN 元素、子查询返回非授权值）
- ❌ 禁止在 SQL 的 WHERE 中省略 `store_code IN (#{omShopCodes})` 条件（所有 SQL 无条件始终启用）
- ❌ 禁止移除营业表的 `LIMIT` 要求
- ❌ 禁止在用户**明确指定门店**时跳过 `sl store find` 直接用 `e000.dt_store_view` LIKE 模糊查询
- ❌ 禁止在 `sl store find` 返回多个候选时静默选择第一条（必须列表让用户确认）