設計系統主控者
一個路由器。讀取應用程式,比對一個劇本,將其步驟一字不漏地複製到 .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 無法還原的步驟),請說明完成了什麼,以及解除阻礙所需的最小回覆。