Starrocks Business Analysis Sly

starrocks-business-analysis-sly

快速导航

用途

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

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

🔐 权限机制

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

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

核心约束速览：

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

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

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

按需预查补全规则

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

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

若 SL_UNIFIED_G_ID 缺失或为空：

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

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

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

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

命令格式

路径见「CLI 入口」；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 数组，每条候选含：

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/security-rules.md

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

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

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

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

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

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

1. 用「CLI 入口」的 Bash 一键兼容 调用（自动选 Windows sl.cmd / macOS sl），禁止 which / where / Bash 内 %USERPROFILE%\...
2. 只打开 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）。

表结构

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

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

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

🔗 七表关联关系

✅ 所有 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

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 等失败。

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

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

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 即可，例如：

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

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

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

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

❌ 禁止（已实测踩坑）

🔧 CLI 配置说明

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

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

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

核心概念

三个金额指标

💡 详细说明 → references/business-context.md

翻台率计算

💡 详细说明 → references/business-context.md

📝 文档维护说明

路径引用规则

Intent 维护规则

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

内容引用原则

禁止事项

• ❌ 禁止在多个文件重复完整的业务概念解释
• ❌ 禁止删除 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 返回多个候选时静默选择第一条（必须列表让用户确认）