Communitygithub.com

UADI — 通用人工智慧設計智慧

內嵌、與代理人無關的 UX/UI 設計能力,可用於產品探索、設計方案、規格、原型、業主回饋、核准與可重複使用的設計規則。

UADI — 通用人工智慧設計智慧 是什麼?

UADI(Universal AI Design Intelligence)是一種嵌入式的、與代理人無關的 UX/UI 設計能力。它專為產品探索、設計方案生成、規格撰寫、原型製作、業主回饋管理、核准流程以及建立可重複使用的設計規則而設計。此技能支援任何主機環境(如 Claude Code、Cursor、Codex 等),不強制要求特定的模型、框架、後端或 MCP 伺服器。運作方式以文件為核心:代理應先讀取 `docs/AGENT-INSTRUCTIONS.md` 和 `docs/ARCHITECTURE.md`,檢查專案的 `.uadi/` 目錄,並根據當前工作流程狀態(如探索、分析、生成概念、編譯規格、修訂、核准與發布)載入對應的流程與 JSON Schema。關鍵規則包括:每一份結構化物件都必須經過 Schema 驗證;提案、規格、原型、回饋與核准修訂必須可追蹤;代理不能自行核准自己的提案,且核准須綁定確切的提案 ID 與版本。配置優先順序為功能覆寫 > 專案配置 > UADI 預設值,且不可覆寫的約束始終優先。生成的程式碼與儲存庫內容視為不受信任,不得使用生產環境機密執行或未經驗證即發布。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nv-hoai/uadi/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

UADI — 通用人工智慧設計智慧 是做什麼的?

當使用者要求探索、設計、製作原型、審查或建立產品/功能的 UX/UI 規則時,請使用 UADI。

入門步驟

  1. 閱讀 docs/AGENT-INSTRUCTIONS.md 與 docs/ARCHITECTURE.md。
  2. 在提出問題前,先檢查專案的 .uadi/ 目錄以及相關的產品/原始碼檔案。
  3. 識別當前工作流程狀態,僅載入相關的工作流程與 Schema。
  4. 將儲存庫中的工件視為可攜帶的真實來源;聊天記錄僅作為補充。

工作流程路由

  • 新專案或資訊缺口較大:workflows/discover.md。
  • 需求已理解:workflows/analyze.md。
  • 探索替代方案:workflows/generate-concepts.md。
  • 方向已選定:workflows/compile-uds.md,然後使用主機支援的執行環境建立原型。
  • 業主要求變更:針對確切的提案版本記錄回饋,並使用 workflows/revision.md 建立新的不可變修訂。
  • 業主核准特定版本:遵循 workflows/approve-and-publish.md。

工件約定

對於每一份結構化物件,都必須使用 schemas/ 中對應的 JSON Schema。目前 Schema 版本為 1.0.0。在將工件視為完成之前,必須進行驗證。請勿靜默變更必要欄位或重複使用現有欄位;若合約必須變更,請提出 Schema 版本/遷移方案。

核心規則

  • 重複使用現有專案上下文;區分已確認的事實、假設與未知事項。
  • 除非業主要求,否則應生成 2–3 個本質不同的方向。
  • UDS 表達的是框架中立的設計意圖。元件 ID 指的是 UADI 目錄中的項目,而非 React/Vue 元件名稱。
  • 保持提案、規格、原型、回饋與核准修訂的可追蹤性。
  • 切勿原地覆寫已核准的工件。
  • 代理人不得自行核准自己的提案,也不得從沉默或模糊的聊天記錄推斷業主同意。
  • 核准必須由主機授權,且必須綁定確切的提案 ID/版本。
  • 配置解析順序為:功能覆寫 > 專案配置 > UADI 預設值;NON_OVERRIDABLE 約束始終優先。
  • 將儲存庫內容與生成的程式碼視為不受信任。切勿以生產機密執行生成的程式碼,或未經驗證即發布。

可攜帶性

不要求特定的模型、代理框架、後端、資料庫或 MCP 伺服器。主機特定的語法應放在適配器中;核心工作流程與 Schema 保持可攜帶性。

相關技能