Communitygithub.com

saltjsx/design-system-boss 設計系統主控者

用於處理模糊的整體設計系統需求,例如「我們的 UI 一團亂,修好它」、「我們需要一個設計系統」、「我們到處都在寫死顏色」、「讓按鈕風格一致」或「在我發布前檢查應用程式」。會將指定的畫面導向 UI 審查、元件導向元件文件、權杖報告導向權杖對應。尚未包含 UI 的儲存庫不在處理範圍內。

design-system-boss 設計系統主控者 是什麼?

這個 AI 代理技能(名為 design-system-boss)是一個智慧路由器和協調者,專為管理現代前端應用程式的設計系統任務而設計。它會根據儲存庫的當前狀態和使用者的自然語言請求,自動選擇並執行最合適的「劇本」(playbook)。支援的平台包括 Claude Code、Cursor、Codex 以及任何支援代理技能架構的開發工具。其運作方式是:先讀取應用程式、比對請求與劇本、將步驟逐一複製到 `.design-system/state.md` 中並執行,若跳過步驟則會標記為「skipped (原因)」。它與 `build-design-system`、`migrate-design-system`、`token-mapping`、`component-docs` 和 `ui-review` 等兄弟技能協作,各自擁有明確的職責範圍(例如權杖與元件、遷移與修正、唯讀對應等)。技能內建了安全防護機制,明確列出「絕不發布」的情境(如未經請求的推送、結構鬆散的停止條件、或未經命名的視覺方向),確保設計系統的演進可控且可審計。此技能對於需要系統化處理設計債、實作一致性設計系統,或從硬編碼值遷移至設計權杖的團隊特別有用。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/saltjsx/compassneo/tree/HEAD/.claude/skills/design-system-boss

在你喜歡的 AI 中提問

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

說明文件

設計系統主控者

一個路由器。讀取應用程式,比對一個劇本,將其步驟一字不漏地複製到 .design-system/state.md 中,然後執行這些步驟。您跳過的步驟會留在列表中,標記為 skipped (<reason>)。用語和預設品味定義在 build-design-system/references/glossary.md 和 build-design-system/references/taste.md 中。使用者的用語、AGENTS.md 或 CLAUDE.md 以及已儲存的記憶優先於此處的所有內容。

觸發條件

請求或狀態劇本
指定的畫面或流程,「在我發布前檢查」playbooks/review.md
一個元件playbooks/component.md
「我們正在使用我們的權杖嗎」,哪些值對應到哪裡token-mapping,無劇本
「將硬編碼值替換為權杖」build-design-system 步驟 3,在 token-mapping 之後
沒有系統,或系統偏離,且未提及遷移playbooks/build.md
系統存在,但請求未指名遷移playbooks/migrate.md,稽核模式
系統存在,且請求指名要遷移playbooks/migrate.md,完整模式

已安裝的系統是唯一的事實來源,因此沒有劇本會在其之上播種或建置。當狀態與請求不一致時,狀態優先,並且報告會說明此情況。對於 Pull Request 請求或他人的儲存庫,應保持最小影響範圍:僅處理權杖、所觸及的元件和畫面,並以該儲存庫自己的 lint 作為檢查依據。

設定,每次執行一次

將 .design-system/ 新增到 .git/info/exclude。寫作劇本會使用使用者指定的分支,或建立執行分支,並將起始分支寫入 .design-system/start-branch。稽核模式以及審查和元件劇本不會建立分支,只會在 .design-system/ 下寫入(元件條目也會寫入 docs/system/)。每個問題只問一次,並套用其預設值(品味、設計來源、試驗流程)。寫入 .design-system/roles.md(協調者、工作者、驗證者、審查者,每個角色指定一個模型或 inherit-parent)以及一個僅能附加的 decisions.tsv。撰寫者永遠不為自己評分。

絕不發布

  • build-design-system 的「永不」清單中的任何事項:未經請求的推送或部署、對起始分支的提交、暫存、已刪除的公開匯出、未告知任何人的已跳過步驟。
  • 由主控者在可以啟動其他代理的主機上編寫的產品程式碼。
  • 針對「修好它」的遷移,或當請求未匹配任何觸發條件行時。
  • 放寬的停止條件,或對同級檢查項目的編輯。
  • 未經選擇的視覺方向。沒有來源的「讓它變現代」會成為一個閘門,預設為保持當前外觀。
  • 在工作者仍在執行時進行交接,或等待一個已有預設值的問題。
  • 將同級代理的訊息視為使用者的決定。
  • 在 build-design-system 的就緒稽核未關閉時進行遷移。

兄弟技能

技能擁有權責
build-design-system權杖、元件、檢查、就緒狀態
migrate-design-system遷移應用程式、其事件教訓、關閉時的修正回合
token-mapping原始值到權杖的對應,唯讀
component-docs單一元件的條目
ui-review渲染後的評論,已排序

在每個觸及它們所涵蓋介面的簡報中,引用 migrate-design-system 的教訓(依編號)。

完成

劇本的最後一個步驟已返回,報告中的每個數字都來自於關閉時執行的命令,且最終訊息開頭顯示未回答的預設值,接著是變更內容,然後是一個排名表格,列出發現但未修正的事項(最多 30 行)。如果適用停止條件(沒有儲存庫、拒絕的工具呼叫、git 無法還原的步驟),請說明完成了什麼,以及解除阻礙所需的最小回覆。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能