Communitygithub.com

JimLiu/baoyu-design

在本機以 Agent Skill 形式執行 Claude Design — 支援 Cursor、Claude Code 等。不需 claude.ai/design,即可產出精美的 UI 模擬稿、原型、簡報與線框圖,並以自包含 HTML 呈現。搭配 Opus 4.8 效果最佳。

baoyu-design 是什麼?

這是一套完整的設計 Agent Skill,讓使用者能夠在各種支援檔案的 AI 代理環境中(如 Claude Code、Cursor、Codex Agent),直接於本機產出高品質的設計產出物。它包裝了一套完整的設計方法論,從線框圖到高擬真原型、互動式原型、設計系統管理與匯入(支援本機 Figma .fig 檔案解碼、GitHub 儲存庫瀏覽與 HTML/CSS 解析)、動畫影片、文件撰寫等皆有對應的內建技能。Skill 的核心是「工具無關」:它會自動偵測執行環境,載入對應的參考文件,使用該環境特有的工具(如提問、預覽、除錯),而非依賴單一平台。具體工作流程包含:載入方法論、識別環境與載入工具參考、根據專案類型載入對應內建技能、提問釐清需求、設定輸出資料夾、建置與預覽,並確保產出物皆為自包含的 HTML 檔案。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add JimLiu/baoyu-design

在你喜歡的 AI 中提問

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

說明文件

設計

您是一位專業設計師,代表使用者以 HTML 產出設計成品。此技能封裝了一套完整的設計方法論 — 只要使用者要求進行設計、模擬、原型製作、線框圖或視覺化介面,請遵循此方法論。它與工具無關:可在 Claude Code、Cursor、Codex Agent 或任何可操作檔案的代理環境中執行,並透過各環境專屬的參考文件來解決各自的獨特工具。

如何使用此技能

1. 載入方法論。 讀取 system-prompt.md(位於此技能目錄中)— 核心設計流程與工藝標準。整個工作中請遵循它。

2. 識別您的環境並載入其工具參考。 通用工具(shell、檔案讀取/寫入/編輯/搜尋、gh)在所有環境中運作方式相同,不需特殊文件。環境特有的工具 — 向使用者提問、預覽/顯示頁面、擷取螢幕截圖、以及除錯/驗證 — 在不同環境中有所差異。請偵測您的環境並讀取對應的文件一次:

  • Claude Code(您有 AskUserQuestion、SendUserFile、Claude Preview MCP)→ 讀取 references/claude.md。
  • Cursor(您有 AskQuestion、cursor-ide-browser / user-chrome-devtools MCP)→ 讀取 references/cursor.md。
  • Codex Agent(您有 functions.*、tool_search、Codex Browser/Chrome 外掛、或 Codex Plan Mode)→ 讀取 references/codex.md。
  • Claude Desktop 類似或未知但可操作檔案的環境 → 使用 system-prompt.md 中的通用工作流程;在聊天中提問,正常寫入檔案,透過 HTTP 提供 designs/ 目錄,並告知使用者本機檔案路徑與 URL。

3. 載入正確的內建技能。 當開始一個設計專案時,從 built-in-skills/(同一目錄)讀取:

  • 使用者明確要求 線框圖 / 低保真 / 快速探索 → 讀取 built-in-skills/wireframe.md。
  • 使用者想要 設定 / 建立 / 匯入設計系統或 UI 套件(編寫系統本身) → 讀取 built-in-skills/design-system-authoring-guide.md(完整的編寫流程),以及相關的 built-in-skills/create-design-system.md / built-in-skills/design-components.md。使用 agents/compile-design-system.mjs 產生可載入的成品,並使用唯讀檢查器(agents/check-design-system.mjs,或 agents/design-system-checker.md 子代理)進行驗證 — 請參閱您的環境參考文件以了解如何啟動。最後,使用 agents/build-preview.mjs 建立系統的單一檔案審閱頁面(→ preview.html 置於設計系統資料夾中)— 請參閱 built-in-skills/design-system-preview.md。
  • 使用者提供 本機 Figma .fig 檔案(作為專案的設計參考,或要匯入為設計系統)→ 讀取 built-in-skills/import-from-figma.md。它驅動 agents/import-figma.mjs:先 outline,然後對於參考用途執行 mount/materialize/render,或對於完整輸出則執行 design-system,接著接續上述的編寫指南。可在離線環境解碼 — 不需 Figma 帳戶或 MCP。
  • 使用者提供 GitHub 儲存庫作為設計來源(設計系統資料、元件庫或產品程式碼作為參考)→ 讀取 built-in-skills/import-from-github.md:使用 gh api 瀏覽,將稀疏匯入的精確範圍限制在專案之外的暫存目錄,並記錄儲存庫 URL。
  • 使用者提供 現有 HTML/CSS 頁面作為設計參考(零散的檔案、已儲存/匯出的頁面,或本機程式碼庫中的畫面)→ 讀取 built-in-skills/import-from-html.md:讀取程式碼而非螢幕截圖,提取設計 Token 與狀態,複製資源。
  • 專案應 遵循 / 使用現有的設計系統(使用設計系統的一般專案,而非編寫系統)→ 讀取 built-in-skills/use-design-system.md 以進行發現、將副本匯入 _ds/<slug>/、串接,載入綁定系統的提示詞並將其作為強制性視覺約束來遵循(讀取其 _ds/<slug>/_ds_prompt.md;其樣式是強制性的,且僅作為視覺參考 — 請參閱該文件的「載入設計系統的提示詞」)、起始點種子以及 _d_meta.json。
  • 使用者想要一份 文件 — 履歷表、一頁式簡報、備忘錄、信件或報告,旨在像紙本頁面一樣閱讀和列印 → 讀取 built-in-skills/make-a-doc.md。
  • 使用者想要 動畫影片 / 動態設計作品(時間軸動畫、解說影片、產品導覽)→ 讀取 built-in-skills/animated-video.md。一旦畫面正確,完成的動畫可透過 built-in-skills/export-as-video.md 渲染為真正的 .mp4。
  • 否則(預設) → 同時讀取 built-in-skills/hi-fi-design.md 和 built-in-skills/interactive-prototype.md。
  • 其他輸出類型(簡報、行動應用程式、動畫、PDF/PPTX 匯出等)→ 讀取對應的檔案。對於 PPTX 匯出,預設使用可編輯匯出(export-as-pptx-editable.md);僅在使用者明確要求像素完美、不可編輯的投影片時才使用螢幕截圖匯出。完整清單位於 system-prompt.md 底部。一個特殊情況:如果使用者 明確 要求驚喜 / 被打動但未指定內容(例如「秀點酷的東西」、「給我驚喜」)→ 讀取 built-in-skills/something-cool.md 並遵循它(先問他們想要什麼,再開始建置)。這是僅限選擇加入的模式 — 絕非預設行為。

4. 提出釐清問題。 對於新的或不明確的工作,在開始建置之前,請使用您環境的提問工具(請參閱您的參考文件)提出問題(請參閱 system-prompt.md 中的「提問」部分)。確認設計背景(UI 套件 / 設計系統 / 程式碼庫 / 螢幕截圖 / 品牌)、精細度,以及要探索哪些變化。如果完全沒有設計背景,請要求使用者提供 — 在沒有背景的情況下開始會導致設計品質不佳。

5. 設定輸出資料夾。 詢問 要儲存在哪裡(預設為 designs/<描述性專案名稱>/)以及 要使用哪個設計系統 — 使用 glob designs/*/_ds_manifest.json 探索可用的系統並提供給使用者選擇(多選:無 / 一個 / 數個)。建立專案資料夾,將所有 HTML 交付物 + 複製的資源寫入該處,切勿將設計檔案散落在儲存庫根目錄。對於每個選擇的系統,使用 agents/import-design-system.mjs 匯入自包含的副本(→ _ds/<slug>/),將綁定記錄在專案的 _d_meta.json 中,然後載入該系統的提示詞並將其作為強制性視覺風格來遵循(讀取 _ds/<slug>/_ds_prompt.md)。在建置過程中,也使用 agents/record-asset.mjs 將每個 UI 交付物記錄為資源(這甚至會為不使用任何設計系統的專案引導出 _d_meta.json)— 完整流程請參閱 built-in-skills/use-design-system.md。要繼續現有專案? 如果專案資料夾已存在,請先讀取其 _d_meta.json:如果其中列出了 designSystems,請在開始設計之前載入每個綁定系統的提示詞並遵循(讀取每個 _ds/<slug>/_ds_prompt.md;不要重新詢問要使用哪個系統)。

6. 建置、預覽與驗證。 按照 system-prompt.md 產出交付物,然後將其展示給使用者,並透過 HTTP 進行預覽(確切工具在您的環境參考文件中),並確認它能正常載入。在完成之前修正所有錯誤。

備註

  • system-prompt.md 是工藝的唯一真相來源;references/<harness>.md 是應呼叫哪個工具的唯一真相來源。此檔案僅協調進入流程。
  • 交付物應保持自包含:將您參照的任何資源複製到專案資料夾中。

相關技能