Communitygithub.com

ProdaZhang/aidd

用一個 AI 腦力激盪功能設計;將經確定性檢查器驗證、平台無關的套件交給另一個 AI 實作。遊戲或應用程式——一個技能,確定性檢查器。

aidd 是什麼?

AIDD (AI-assisted Design→Dev) 是一個用於從設計討論生成平台無關交接套件的 AI 代理技能,該套件可讓另一個 AI 直接據以建置,並由確定性檢查器在交接前把關,確保無重大問題。它適用於設計任何以設定、規則或 UI 為主的系統,如遊戲系統、應用程式與 SaaS 功能(方案、配額、權限、功能旗標、表單、入門引導)或工具,也能用來推進或同步專案主幹。此技能會讀取專案主幹,判斷進度,並將使用者路由至 `references/` 中對應階段的劇本。它支援 Claude Code、Cursor 等主流 AI 代理平台,並以純 Python 腳本(多為標準庫)作為確定性檢查器,驗證設定漂移、損壞的引用、覆蓋率等。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add ProdaZhang/aidd

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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。

進入時——自我檢查,然後路由(主動推進)

  1. 主幹是否存在?(project-charter + manifest)—— 否 → 從概念階段開始建立。是 → 讀取兩者。
  2. **哪些系統尚未標記為 Final?**列出它們;詢問本次要推進哪個。
  3. 是否有 Recheck 系統?(有共用項目被更改)→ 先透過定稿/同步階段解決。
  4. **編號範圍衝突 / 依賴循環?**檢查並回報。

階段(讀取對應劇本,然後執行工作)

你想做什麼讀取
概念:核心循環 / 平台 / 用戶 / 拆分系統 / 啟動主幹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 初始化。

相關技能