onsystem
讓編碼代理遵循您的設計系統:在每次編輯和拉取請求中,捕捉調色板顏色、原生元素及系統缺少的 API,並提供修正。設定
onsystem 是什麼?
讓編碼代理遵循您的設計系統:在每次編輯和拉取請求中,捕捉調色板顏色、原生元素及系統缺少的 API,並提供修正。在您的設計系統套件中設定一次,單一儲存庫中的每個應用程式即可使用。
onsystem 概覽
這是什麼
onsystem 是一個讓程式碼代理(coding agents)遵循你設計系統的工具。它能在每次編輯和 pull request 中,捕捉調色盤顏色、原生元素以及你的系統缺少的 API,並附帶修正。它在本機執行,並可與 @shadcn/lint 搭配使用。此工具專為擁有 React 設計系統套件的設計系統與平台團隊打造;shadcn/ui 應用程式是零設定的示範範例。它之前的名稱是 @dgesteves/design-system-mcp。
主要功能
- 在每次編輯和 pull request 中,捕捉設計系統缺少的調色盤顏色、原生元素和 API,並提供修正。
- 使用 TypeScript 編譯器從原始碼讀取你的元件、cva 和 tv 變體、零件和 token,並針對 .tsx 和 .jsx 檔案進行檢查。
- 每個發現都有規則 ID、位置和修正。
- Token 可來自你的樣式表、DTCG 2025.10 檔案或 DESIGN.md;
onsystem export可將其輸出為任一格式。 - 透過外掛整合 Claude Code,提供 hook、MCP 伺服器和技能;也支援 Cursor、VS Code 及其他代理。
- 支援 CI 整合:安裝為開發依賴,使用基準線接受既有發現,僅在新發現上讓 pull request 失敗。
- 提供 GitHub Action,執行相同的檢查、尊重基準線,並僅對 pull request 變更的行加上註解。
使用情境
- 確保程式碼代理撰寫的 UI 元件符合設計系統,而非使用硬編碼顏色、原生元素或不存在的元件。
- 在開發過程中(每次編輯)和 pull request 中捕捉設計系統違規。
- 在 monorepo 中導入新應用程式:在設計系統套件中設定一次,每個應用程式自動獲得檢查。
- 整合到 CI/CD 管線中,透過基準線支援既有程式碼,強制執行設計系統合規性。
快速開始
內容整理自該專案公開的 README 與儲存庫資訊。