AIDD · 編排器(單一技能)
AIDD = AI 輔助設計→開發。將設計討論轉化為平台無關的交接套件——規則/設定/合約/驗收標準/UI 原型/主幹——讓另一個 AI(或真人)可以直接據以開發,並由確定性檢查器在交接前把關至「0 個重大問題」。領域中立:同一引擎既能設計遊戲系統,也能設計 SaaS 計費功能。實作落地(選擇技術棧來撰寫客戶端/伺服器)是後續環節,不在本套件範圍內。
這是一個技能涵蓋整個管線。各階段的詳細劇本放在
references/中,按需讀取——讓上下文保持精簡,無需拆分成多個技能。
核心模型
- 兩層結構:① 即時專案主幹——
project-charter(概念/平台/目標用戶/領域/命名慣例)+manifest(系統清單 + 依賴圖 + 跨層索引 + 編號範圍註冊表 + 凍結記錄簿),持續修訂;② 每個系統的生產循環。 - 集中化事實來源:列舉值/編號/合約/設定表都在專案層級;散文描述透過名稱引用,位置無關(
table[key].field/screenID.elementID/R-code)——絕不內嵌裸數字。 - 每個操作:讀取主幹 → 執行工作 → 寫回主幹。
- 標準方法:
references/methodology.md。常見陷阱:references/gotchas.md。各工具平台適配細節:references/harness-adapt.md。
進入時——自我檢查,然後路由(主動推進)
- 主幹是否存在?(
project-charter+manifest)—— 否 → 從概念階段開始建立。是 → 讀取兩者。 - **哪些系統尚未標記為
Final?**列出它們;詢問本次要推進哪個。 - 是否有
Recheck系統?(有共用項目被更改)→ 先透過定稿/同步階段解決。 - **編號範圍衝突 / 依賴循環?**檢查並回報。
階段(讀取對應劇本,然後執行工作)
| 你想做什麼 | 讀取 |
|---|---|
| 概念:核心循環 / 平台 / 用戶 / 拆分系統 / 啟動主幹 | references/phases/concept.md |
| 設計系統:規則 (R-code) + 設定表 (測試資料) + UI 原型 | references/methodology.md — 步驟 0–5,A 部分 |
| 流程演練後疊代:調整規則/設定/原型(低成本、可重複) | references/methodology.md — 重新執行 A 部分 |
| 定稿與交接:合約 + 驗收標準 + (必要時) 後端 + 檢查清單;然後同步主幹 | references/methodology.md B 部分 + references/handoff-checklist.md |
| UI 截圖 → UI DSL(將參考畫面擷取至知識庫) | references/phases/ui-capture.md |
典型路徑:概念 (一次) → 每個系統 { 設計 → 疊代… (重複) → 定稿與交接 } → 同步 (持續)。不強制順序——根據工作需求路由。重新拆分/回退會在 manifest 中記錄回退日誌項目,並將已定稿的下游系統標記為
Recheck。
確定性檢查器(門檻——交接前執行)
references/scripts/(純 Python,多為標準庫):config_check (設定規格 ↔ xlsx 漂移) · value_check (損壞的外來鍵/覆蓋率/單調性) · manifest_check (主幹自我一致性) · ref_graph --check (懸空的 R-code/引用) · gherkin_to_checklist · ui_render (UI-DSL → 線框圖)。0 個重大問題 = 可交接。 可執行範例:references/examples/subscription-plans/。
邊界(它不是什麼)
- 管理結構與一致性,而非品質判斷:檢查器能捕捉損壞的連結/覆蓋率/單調性/結構漂移;但不判斷設計好壞(遊戲平衡、使用者體驗、業務正確性)——這留給真人/專用工具。
- HTML 原型驗證資訊架構與流程,而非感受/時機/網路。適合 UI 密集的畫面(庫存、商店、設定、儀表板、入門引導);即時感受交給工程原型。
- 不決定你的數字/慣例:任何未決事項會標記為
[待確認]並交由真人處理。 - 範圍止於交接套件;技術棧選擇與客戶端/伺服器實作 = 後續環節。
套件(一個資料夾)
將單一的 aidd/ 技能資料夾安裝到主機的技能目錄中(例如 Claude Code 的 .claude/skills/)。所有內容——方法論、檢查器、範本、範例——都放在 aidd/references/ 下。領域套件(應用程式/遊戲模式 + 範例)則放入 references/patterns/ 和 references/examples/。
硬性限制(不得違反)
- 檔案為 UTF-8 無 BOM。
- 依名稱引用(位置無關);萬分比統一使用
/10000。 - 集中化設定:表格全域池化,無每個系統的私有表格;跨系統引用只是普通引用,不是依賴邊緣。廣播類型的共用來源(ID 命名空間/列舉值/文字)為只能附加,絕不破壞。
- 工具呼叫必須使用所屬工具平台的函式呼叫格式,否則可能靜默失敗——請驗證產出物確實已落地(read-file /
ls)。各平台適配細節見references/harness-adapt.md。 - 每次變更後,在專案變更記錄(
CHANGELOG.md)中附加記錄;若無則從references/templates/CHANGELOG.tpl.md初始化。