本目录为可搬迁的技能包：根目录 SKILL.md 为总控；skills/ 下为子技能正文（名称见下表）。执行时必须 Read 对应文件，不要凭对话记忆冒充已读。
对外分发：若将本包提供给组织外或公共注册表，请先按贵司规范审查、删减或替换 skills/ 内可能带有示例业务口径、表名样例或内部路径的段落；总控层已避免写入具体环境路径。
skills/ 目录树相对位置不变；子技能之间的依赖已指向同捆相对路径 skills/sql-review-controller/SKILL.md。 {{WIKI_ROOT}}（知识库根）不在本包内。若宿主未在配置或环境变量中设定、且当前工作区也无法唯一推断时：必须先请用户手动选择知识库根目录（建议给绝对路径），用户书面确认后再读写；确认前对知识库树只读或不访问。 {{WIKI_ROOT}} 后，若磁盘上尚不存在约定子树，应在流程中主动说明并协助创建（须用户同意后再 Write 落盘）——见 references/exec-runbook.md §0.1。| # | 做什么 |
|---|---|
| --- | -------- |
| 1 | Read {baseDir}/references/exec-runbook.md，按 A～D 节执行。 |
| 2 | Read {baseDir}/skills/skill-router/SKILL.md，输出 RouterInput / RouterDecision。 |
| 3 | 按 next_skill：Read skills/（路径相对本包根），严格按该文执行；SQL 主链须覆盖 sql-generator → sql-review-controller。 |
| 4 | 子技能结束后更新 state，回到步骤 2，直到 next_skill: none 且可交付。 |
冷启动：依赖 {{WIKI_ROOT}} 的步骤前，若目录不存在，按 references/exec-runbook.md §0.1 引导创建。取数 SQL（/gen）在路径就绪后还须通过 §0.3：先填充 raw/ → /ingest（wiki 编译），再进入 B 的 initial_sql 步骤。
| 能力 | 打开 |
|---|---|
| ------ | ------ |
| 路由 | {baseDir}/skills/skill-router/SKILL.md |
| 写 SQL / 资料闸 | {baseDir}/skills/sql-generator/SKILL.md |
| 审查 JSON | {baseDir}/skills/sql-review-controller/SKILL.md |
| 知识库 | {baseDir}/skills/wiki-maintainer/SKILL.md |
| 文件 | 用途 |
|---|---|
| ------ | ------ |
{baseDir}/references/exec-runbook.md | 逐步执行表（A～D） |
{baseDir}/references/router.md | 路由字段速查 |
{baseDir}/references/kb-gate.md | 资料闸速查 |
{baseDir}/references/review.md | 审查路由速查 |
{baseDir}/references/wiki.md | 知识库门禁速查 |
{baseDir}/references/improvement-loop.md | 持续改进与闭环自检（泛化，可选） |
{{WIKI_ROOT}}：知识库根（含 wiki/、raw/、outputs/ 等约定子树）。未设置且无法从上下文唯一确定时：请用户选择路径（绝对路径或相对工作区根）并确认后再继续。 {{SQL_ENGINE}}：目标数仓引擎标识，由项目配置，本总控不举例具体品牌。需要「双层记忆」写入与检索链时，请单独安装同仓库 data-analysis/memory/ 技能目录（根为 SKILL.md，name: double-layer-memory）。本包总控与执行手册不包含记忆环节，也不在路由表中挂载该技能。
共 1 个版本