把字段理清楚
把业务线、战区、日期、销量等常用字段整理好，原始表格不改动。
从一张业务表格，
到可以直接提问的工具
把一张业务表格整理成可以反复使用的查询工具，并准备接入乐搭，让日常查数更简单。
SKILL HUB · NEXTSkill 将要上线
乐搭将安装部署
乐搭将安装部署
SCROLL TO EXPLORE
01 · 先说结论
这不是一次临时做出来的工具，而是一套准备上线、后续可以重复使用的查询方案。
先把表格整理清楚，再把常见问题和计算方法固定下来，最后进入 Skill Hub 和乐搭，形成从数据到使用的完整流程。
先把问法对齐
用常见问题核对销量、别名、空值和计算方法。
同一个问题同一种答案
按表格里的实际写法识别产品线，销量、战区、日期和活跃率按同一套方法计算。
目前判断
先由业务端输出并清理数据表格，再用 Codex 生成 Wiki 数据库；梳理业务场景后交给 Codex 生成 Skill，连接 Wiki 与 Skill 提问验证并修改，最后按准入规则上传 Skill Hub，再安装到乐搭。
✓ 下一步 · Skill Hub 上线 · 乐搭部署
02 · 怎么使用
把前面的整理结果，接到日常使用入口。
先把表格、问题和计算方法整理好，再接入乐搭，使用时可以直接提出业务问题。
使用方式 01
先整理，再使用
先把表格和常见问题整理清楚；真正使用时，只需要提出业务问题。
路径：整理数据 → 固定方法 → 进入乐搭使用方式 02
版本统一，方便维护
集中保存一份可用版本，后续更新时按同一套方法调整，减少前后口径不一致。
方式：统一发布 · 后续可维护03 · 整体步骤
把每一步都留下一份清楚的结果。
数据表格、Wiki 数据库、业务场景、Skill、测试问题和上线文件分步整理，后面检查或更新时更容易找到。
从表格到乐搭的 7 个步骤
每一步都有对应结果，方便检查和交接01
数据清理输出数据表格清理无关数据
02
Wiki 数据库使用 Codex整理表格内容
03
业务场景查数、做对比整理常见问题
04
生成 Skill场景交给 Codex生成业务 Skill
05
验证和修改连接 Wiki 与 Skill提问验证并修改
06
Skill Hub符合准入规则迁移并上传
07
乐搭下载并安装 SkillDT 协助操作
04 · 制作过程
七个阶段，把一次需求整理成可以使用的工具。
下面按实际过程，依次展示输入、处理和结果。
可以按数据、构建或上线阶段查看。
01
业务端输出并清理数据表格
业务端输出数据表格，先清理无关数据，保留后续查询需要的内容。
worksheet / cleaned-fields
业务线店面战区上报日期销量是否核算PO疑似异常
Moto西北上报日期1是#N/A
Moto华北上报日期1是#N/A
Moto华南上报日期1是#N/A
Tablet东南上报日期1是#N/A
保留字段字段契约已整理
原始表格只读保留
这一阶段的结果 · 表格整理
先把表格整理清楚
先确认业务线、战区、日期、销量和校验字段，后面的查询都按这套字段来做。
- 原始表格不被修改
- 字段来源找得到
- #N/A 按约定处理
02
使用 Codex 生成 Wiki 数据库
使用 AI 编程工具 Codex，把表格内容整理成 Wiki 数据库，供后续读取。
llm-wiki / snapshot / table.json
table.jsonraw / spreadsheets · read only
source verifiedcolumns_metacatalogued
recordsindexed
#N/Araw value kept
这一阶段的结果 · 内容归档
把资料放到统一位置
把表格内容、字段说明和更新记录放在一起，后续查询从同一个位置读取。
- 表格内容保留完整
- 来源记录找得到
- 后续更新有记录
03
梳理业务场景：查数、做对比等
把查数、做对比等常见场景整理成具体问题和处理方法。
sales-query / rules / metrics
confirmed-metric-rules.md冻结口径 · source: table.json
frozen上报销量
sum(销量)是否加入核算 = 是门店销量
sum(销量)PO疑似异常 ≠ 是PO校验达标销量
sum(销量)PO地址及时间校验是否达标最终 = 是SN活跃达标销量
sum(销量)SN活跃次数是否达标 = 是平板 → Tablet手机 / MOTO → Moto#N/A → 空
这一阶段的结果 · 计算方法
先把问题和算法说清楚
把字段选择、产品叫法、空值处理和活跃率算法先说清楚，后面同类问题按同一方法计算。
- 平板：Tablet
- 手机：Moto
- 战区和每日按表格字段
04
将场景交给 Codex 生成 Skill
把整理好的业务场景交给 Codex，生成业务 Skill，并保留固定的计算方法。
Codex / workspace / sales-query
skill 生成sales-query · Codex
READY你
基于 Wiki 数据库和业务场景，生成可查询的 Skill，并保留固定计算方法。
Codex
已按场景生成 Skill，创建以下文件：
SKILL.mdreferences/scripts/tests/
TERMINALcalculate_metrics.js
› node scripts/calculate_metrics.js --business-line Tablet --store-zone 华北✓ Skill package ready · output contract checked这一阶段的结果 · 可使用工具
把方法放进工具里
让工具负责理解问题和组织回答，数字按固定方法计算，减少前后说法不一致。
- 常见问题可以直接问
- 数字按同一方法计算
- 版本信息找得到
05
连接 Wiki 与 Skill，提问验证并修改
把 Wiki 知识库和 Skill 连接起来，通过提问验证结果，再根据结果修改。
tests / question-set.test.js
question-set.jsonquestionnaire regression
GREEN✓
战区按日销量查询平板 · 店面战区 · 上报日期
passed✓
活跃率口径SN 活跃达标销量 ÷ PO 校验达标销量
passed✓
别名与空值边界平板 → Tablet · 手机 / MOTO → Moto · #N/A → 空
passedsource contractinput guardmetric projection
这一阶段的结果 · 问题核对
用真实问题反复核对
每次调整后都重新问一遍常见问题，确认结果、叫法和空值处理没有变化。
- 问题可以重复检查
- 回答方法保持一致
- 战区结果可以对照
06
按 Skill Hub 准入规则整理 Skill 包、版本、权限和相关说明，迁移并上传。
07
下载 Skill，安装到乐搭，DT 协助完成操作。
06 · 上线后的使用方式
上线之后，按同一套方法稳定使用。
Skill Hub 负责统一发布，乐搭负责日常使用；表格内容、版本信息和检查记录一起保留，方便后续维护。
上线事项怎么做状态
前面整理，后面使用前面把表格和问题整理好，乐搭负责日常使用。已安排
版本统一Skill Hub 保留统一版本，乐搭使用发布后的版本。已安排
内容可追溯知识库保留原始内容和更新记录，后续调整有据可查。已接入
使用方法清楚同类问题按照同一套方法回答，减少不同人理解不一致。已纳入
07 · 下一步安排
Skill 准备上线，业务入口随后接入。
前面的表格整理、问题核对和计算方法已经准备好，下一步进入 Skill Hub 上线和乐搭安装。
NEXT 01
Skill Hub 上线准备
sales-query 已经整理好，下一步按平台流程提交。
NEXT 02
乐搭安装准备
上线后由 DT 协助下载并安装到乐搭，接入日常提问。
NEXT 03
常见问题已核对
销量、战区、日期和活跃率等问题已经按固定问法核对。