技能介绍

当已有 SQL 代码、业务口径和数仓表结构分散在分析师与产运团队手中时，主要问题不是能不能写 SQL，而是取数请求、资料核对、生成和审查如何稳定复现。data-extract 将这些问题组织成可搬迁的同捆技能包：根目录 SKILL.md 负责总控，skills/ 下存放路由、生成、审查和知识库维护子技能，执行时要求 Read 对应文件，而不是凭对话记忆冒充已读。

核心工作方式

路由先行：每次任务先读取 references/exec-runbook.md，再由 skills/skill-router/SKILL.md 输出 RouterInput 与 RouterDecision，决定下一步 next_skill。
SQL 主链：取数 SQL 主链覆盖 sql-generator 与 sql-review-controller，把生成结果和审查 JSON 分开处理。
知识库门禁：依赖 {{WIKI_ROOT}} 的步骤要求知识库根目录明确；若宿主未配置且上下文无法唯一推断，需要用户确认路径后再读写。取数 SQL 在路径就绪后，通常先填充 raw/ 并经过 /ingest 编译，再进入 initial_sql 步骤。
状态闭环：子技能结束后更新状态，回到路由判断，直到 next_skill: none 且结果可交付。

适用边界与注意点

该包更适合已有 SQL 代码、需要资料闸和审查链的数据分析与产运场景。它不包含 double-layer-memory 记忆写入与检索链，也不绑定具体数仓品牌，{{SQL_ENGINE}} 由项目配置决定。对外分发前，应审查 skills/ 中可能存在的示例业务口径、表名样例和内部路径，避免把环境细节带入公共注册表。