技能:治理
在系統成長的過程中保持其一致性。套用版本管理、貢獻與棄用規則。
步驟
- 讀取
workflows/governance.md(SemVer 表格、貢獻流程、棄用政策、變更溝通)。 - 對變更進行分類:major(破壞性 — 重新命名/移除 token 或 prop、改變結構/預設值)、minor(新增性 — 新的 token/元件/變體/選用 prop)、patch(修正 — 在容許範圍內的對比度/錯誤/文件/值調整)。
- 針對新元件/token:在從 product → candidate → core 提升前,確認它確實滿足一個真實且重複的需求(至少 2 處使用)。並按照最高品質標準進行設計(
.claude/rules/components.md→ 元件品質標準)。 - 針對棄用:標註原因 + 替代方案 + 移除版本;保留至少一個 minor 版本週期;提供遷移對照表(採用
design-systems/crosswalk.md的風格);僅在 major 版本中移除。 - 將任何新檔案接入
CLAUDE.md(檔案參考對照表 + 相關表格/路由器)並新增更新日誌條目。
驗證(完成定義)
- 變更必須有 SemVer 等級以及一條更新日誌條目。
- 移除操作必須有棄用窗口、替代方案以及遷移對照表。
- 新的規格必須滿足 8 狀態 + 無障礙 (a11y) + token 對應標準,並且可透過路由器存取。
python3 scripts/validate_tokens.py必須通過;若顏色變更,需重新檢查對比度。