Thariq Skills #5 — Code Scaffolding & Templates：框架樣板生成的 Skill 模式
建新的 workflow、migration、或 app 時，你的團隊有標準的結構嗎？
如果有，那這個結構就應該成為一個 skill——讓 agent 每次都按標準做，而不是靠它猜。
類別定義
“Generate framework boilerplate. Combine with composable scripts. Useful when scaffolding has natural language requirements.”
這個類別特別強調「自然語言需求」的場景。純腳本可以做 scaffolding，但如果你需要「建一個新的 user onboarding workflow，用 TypeScript，接 billing-lib」——這種帶有業務邏輯的需求，純腳本做不到，但 agent + skill 可以。
Thariq 的範例
new-workflow — 建立新的 workflow 模板。預設的檔案結構、必要的 import、測試設定、CI 配置——全部按標準產生。
new-migration — 資料庫 migration 樣板。正確的命名規範、up/down 結構、測試框架整合。
create-app — 新應用程式的完整 scaffold。多個子系統（frontend、backend、infra）的標準結構，以及它們之間的整合設定。
為什麼是 skill 而不只是腳本
純腳本能做固定的 scaffolding，但 skill 的優勢在於它能理解自然語言的變體：
# 純腳本的極限：
./create-workflow.sh user-onboarding
# Skill 能理解的需求：
"幫我建一個新的 user onboarding workflow，
要用 TypeScript，接 billing-lib，
還有需要一個 admin review step"Agent 讀取 skill 的模板、了解你的標準、然後根據自然語言需求調整產生的結果。
把 scaffolding 的「不可變部分」（檔案結構、必要設定）放在assets/ 資料夾作為模板，「可變部分」（業務邏輯、名稱、依賴）讓 agent 根據需求填入。這樣既保持標準，又有彈性。
結合可組合腳本
Thariq 強調「combine with composable scripts」。這對應到他的技巧 #8：給 agent 可組合的函式，讓它把回合用在構思與決策上，而不是重建樣板。
new-workflow/
├── SKILL.md ← 觸發條件 + 使用說明
├── assets/
│ ├── workflow-template/ ← 標準目錄結構模板
│ │ ├── index.ts.template
│ │ ├── test.ts.template
│ │ └── README.md.template
│ └── scripts/
│ ├── create-files.sh ← 建立目錄結構
│ ├── setup-tests.sh ← 設定測試框架
│ └── register-workflow.sh ← 在 registry 中登記
└── gotchas.md ← 常見錯誤（如命名規範）Agent 組合這些腳本，而不是從頭寫每個步驟。
SuperPortia 實戰觀點
SP 在這個類別有比較好的覆蓋：
/create skill 是 SP 最完整的 Scaffolding skill，涵蓋：
- 新專案的完整目錄結構（ADR-0010 標準）
.gitignore、CONTRIBUTING.md、ADR 索引- git remote 設定
verify-project-scaffold.sh驗證腳本
architecture-doc skill 補充了文件生成的部分。
但有一個已知的弱點：/create skill 是 L3（按需載入），在 2026-03-15 的 nqio 事件中，agent 沒有自動載入它，導致 scaffold 不符合標準。後來加了 project-creation-gate.md rule 強制要求：建新專案前必須載入 /create skill。
Scaffolding skills 特別容易被跳過，因為 agent 通常「以為自己知道怎麼建」。解法是：（1）在 description 欄位寫明觸發條件（「任何建立新 repo / 新專案的情況」），（2）配合 L2 rule 強制要求載入。兩者缺一不可。
ADR-0010 scaffold 是最好的候選
SP 的 ADR-0010 定義了 monorepo 分拆的標準結構。這個結構——加上 verify-project-scaffold.sh 的驗證——是一個非常好的 skill 強化對象：
create/
├── SKILL.md
├── templates/
│ ├── adr-repo/ ← ADR-0010 標準 repo 結構
│ └── astro-site/ ← SP 標準 Astro 網站結構
└── scripts/
└── verify-scaffold.sh回到總文
本文是九大類別系列的第五篇。完整框架與 SuperPortia 對照請見：
...iq-skills-business-automation|Thariq Skills — Business Process & Team Automation]] — 一個指令搞定重複工作流 5. [[Thariq Skills — Code Scaffolding & Templates]] — 框架樣板生成的...