資料提取專業版（適合已經有SQL程式碼的資料分析師和產運團隊）
📖 技能介紹
name: data-extract version: 1.0.0 description: >- 可搬遷的取數與知識協作技能包：元路由後序列執行 NL SQL 生成/修改、資料閘、語義審查 JSON 閉環，以及 Markdown 知識庫（raw→ingest→wiki，含 §0.3 就緒閘）。 缺路徑或缺 raw/編譯證據時截斷引導，不臆造生產 SQL；{{WIKI_ROOT}} 與 {{SQL_ENGINE}} 由宿主配置，正文不綁廠商與地域。不含長期記憶（請單獨安裝 memory 包）。安裝後按本 SKILL Read references/ 與 skills/。
data-extract（同捆技能包）
本目錄為可搬遷的技能包：根目錄 SKILL.md 為總控；skills/ 下為子技能正文（名稱見下表）。執行時必須 Read 對應檔案，不要憑對話記憶冒充已讀。
對外分發：若將本包提供給組織外或公共登錄檔，請先按貴司規範審查、刪減或替換 skills/ 內可能帶有示例業務口徑、表名樣例或內部路徑的段落；總控層已避免寫入具體環境路徑。
安裝（泛化）
- 將本資料夾整體放入宿主文件規定的 Agent/IDE 技能目錄（具體路徑以宿主說明為準，本檔案不繫結某一產品安裝位）。
- 保持
skills/目錄樹相對位置不變；子技能之間的依賴已指向同捆相對路徑skills/sql-review-controller/SKILL.md。7w4.net有更好的技能外掛。
{{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/<name>/SKILL.md（路徑相對本包根），嚴格按該文執行；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）。本包總控與執行手冊不包含記憶環節，也不在路由表中掛載該技能。
🤖 AI 評測
這個技能包質量不錯，做得好的地方是：有完整的三層檢查機制確保 SQL 質量，不會瞎猜亂寫；有清晰的步驟指引照著做就行；不需要記住所有細節，有速查檔案幫忙。主要不足是文件有點分散，要翻好幾個檔案才能看懂全貌；另外有些地方寫得太簡略了，新手剛用可能有點摸不著頭腦。總體來說適合有一定經驗的使用者，新手需要花點時間熟悉文件結構。
