技能包

OpenDesigner:用幾句回答為專案鋪出設計系統

適合需要為正在開發的 AI 程式專案建立統一視覺規範的團隊,安裝外掛後回答最多五個簡短問題,即可產生 DESIGN.md、PRODUCT.md 與 opendesigner/ 代幣產物;前置條件是本機具備 Python 3.10 或更新版本。

官方來源 · ckryptickunal/OpenDesigner

安裝

/plugin marketplace add ckryptickunal/OpenDesigner
    /plugin install opendesigner@opendesigner

適合誰

適合已經在用 AI 程式助手、但專案還缺一套統一視覺規範的開發者與小型團隊:你手裡可能只有幾頁設計稿或幾句口頭描述,程式碼裡的顏色、字體、間距卻在每個頁面各寫各的;也可能是專案剛起步,誰都抽不出時間先做一整套設計系統。它是加裝在你現有 AI 工具裡的外掛套件,作用是把講不清的審美偏好變成程式碼能直接消費的檔案,而不是再開一個設計軟體;它是 MIT 授權的免費開源專案,不會取代你正在用的編輯器,只是往裡加一層能力。凡是願意回答幾個簡短問題、接受結果寫進專案目錄、並願意在合併前自己再過一遍的人,都適合先跑一次。剛接手別人寫的程式碼、想先摸清視覺基調的人,也可以拿它做一次快速勘察。

3 分鐘完成第一次嘗試

先檢查前置條件:機器上要有 Python 3.10 或更新版本。引擎只是一個 Python 檔案,不需要安裝相依套件。

第一步,安裝技能。推薦路徑是 Claude Code 的外掛市集:在對話裡輸入 /plugin marketplace add ckryptickunal/OpenDesigner,按 Enter 後再輸入 /plugin install opendesigner@opendesigner。

第二步,認準安裝位置。支援 Agent Plugins 的工具會讀取根目錄的 plugin.json,而讀取技能的客戶端約定從 .agents/skills/ 目錄取檔案;不走外掛市集路徑的客戶端,需要你自己把技能複製進專案的 .agents/skills/。

第三步,觸發一個低風險任務。開啟你的專案,在對話裡說「Create a design system for this project.」,它會拋出最多五個簡短問題,每個問題都附上建議答案與理由,你逐條確認或改寫即可。第一次盡量挑一個乾淨目錄跑,或先開一個分支,這樣產生的代幣不會跟既有程式碼混在一起。

第四步,先約好副作用與確認點。引擎會把結果寫成 DESIGN.md、PRODUCT.md 以及 opendesigner/ 目錄,裡面放著代幣、各類匯出與一個概覽頁。寫入檔案會直接改寫儲存庫內容,所以先建立分支或提交一次;確認完答案再讓它寫。

第五步,看可觀察的成功訊號。專案裡出現上面那三個產物,而且自我檢查環節沒有報錯:文字對比度依 WCAG 2.2 AA 檢核、點擊目標不小於 24 px、鍵盤焦點可見,並處理了減少動態效果偏好;只要出現錯誤,建置就會停下來。

使用案例

案例一:為新專案鋪出第一版設計系統。裝好外掛後,在專案裡說出上面那句英文觸發語,回答它提出的最多五個簡短問題,就能拿到一版完整的設計系統,而不是零散片段。第一版不必追求完美,它本來就是給你繼續追問與迭代的起點。接著可以往下鑽:顏色、字體、間距、動效這四類都能各自再問一輪細化,產物始終落在同樣那三個檔案與目錄裡。證據僅止於此——官方文件寫明了問題上限是五個、細化維度就是這四類,但沒有說明能否調整問題數量,也沒有描述每一輪細化的互動形式。

案例二:在沒有外掛市集的客戶端裡重用同一套技能。把技能複製進專案的 .agents/skills/ 目錄,然後照舊在對話裡要求生成設計系統並回答問題,產出與自我檢查規則跟案例一完全一致。如果專案裡已有代幣命名慣例,動手複製前先確認兩套命名不會打架。官方只說明了這些客戶端從該目錄讀取技能,沒有交代複製之後如何更新,也沒有給出額外的相依套件或設定步驟。

使用邊界

引擎的硬性要求只有一條:Python 3.10 或更新版本,除此之外不需安裝任何相依套件。安裝方式也只有官方文件寫明的那幾條:外掛市集之外必須手動複製技能,官方並未為手動路徑提供自動更新或檢核命令。它執行時會直接改寫專案檔案,所以動手前先留好分支或提交。內建自我檢查是硬門檻,對比度未達 WCAG 2.2 AA、點擊目標小於 24 px、鍵盤焦點不可見、或者沒有處理減少動態效果,都會讓建置停下來;它不會替你修,改完得重跑一遍。五題問答的前提是問題本身能被簡短回答,涉及複雜業務規則時,引擎給不出判斷。設計系統也不是最終產物:代幣與文件留在儲存庫裡,如何與既有元件庫合併、是否納入版本控制,官方文件都沒有交代,需要你自己判斷。儲存庫網址:<https://github.com/ckryptickunal/OpenDesigner >。