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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/dgestevesonsystem.svg)](https://yunodb.com/tools/dgestevesonsystem?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/dgestevesonsystem?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/dgestevesonsystem.svg" alt="Featured on YunoDB" height="20"></a>