Communitygithub.com

rahul-sha/portfolio-design-system

在修改此作品集的視覺外觀(顏色、字體、間距、圓角、動畫、面板、卡片、對話框)時使用,以確保變更遵循網站的設計 Token 和對比度規則。

portfolio-design-system 是什麼?

這項技能定義了此作品集網站的完整設計系統,所有視覺風格屬性均以 CSS 自訂屬性(Token)集中管理於 `index.html` 的 `:root` 區塊。開發者不得使用未經 Token 對應的原始數值,任何新增值都必須同時在 `:root` 和 `DESIGN.md` 中建立對應條目。文字與背景必須成對定義,並須通過 WCAG AA 對比度檢查,且系統明確禁止引入深色模式。此外,該設計系統在 Claude 中有一個對應的 Design System Artifact,當 HTML/CSS 或 `DESIGN.md` 變更時,必須同步更新該 artifact 的 `project/tokens.json` 和 `project/README.md`,以確保三個副本保持一致。此技能支援的平台為任何基於該作品集的開發流程,透過強制執行 Token 化設計和對比度規則,確保風格一致性與可及性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rahul-sha/aanchal-portfolio/tree/main/.claude/skills/portfolio-design-system

在你喜歡的 AI 中提問

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

說明文件

作品集設計系統

此網站擁有一個設計系統。在進行任何樣式修改之前,請先閱讀儲存庫根目錄下的 DESIGN.md,並以此為基礎進行工作。

規則

  1. 每個顏色、字型大小、間距尺度、圓角半徑和持續時間,都應是位於 index.html 頂端 :root 區塊中的 CSS 自訂屬性(Token)。在規則中使用 Token。切勿撰寫任何 Token 已涵蓋的原始十六進位值、像素尺寸或持續時間。
  2. 新的值需要在 :root 中建立新的 Token,並在 DESIGN.md 中新增對應的行,所有變更應在同一組修改中完成。 設計系統也以 Design System artifact 的形式存在於 Claude (https://claude.ai/artifact/2iPwsVBSqA9gs8nkaYC5g1)。當此處的 Token、模式或規則發生變更時,必須在同一項工作中同時更新該 artifact 的 project/tokens.json 和 project/README.md,以確保三個副本永不偏離。
  3. 文字和背景必須成對出現。新增的面板顏色類別必須同時設定兩者。請根據 DESIGN.md 中的 AA 清單檢查配對情況,並在提出 pull request 前執行 README.md 中提到的 axe 掃描。
  4. 本網站沒有深色模式。請勿新增 prefers-color-scheme: dark 規則。頁面有意將 color-scheme 設定為 light。
  5. 動畫效果使用 --ease 和 --dur-* Token,並且必須在 prefers-reduced-motion: reduce 啟用時停止。
  6. 測試時需在 390px 和 1280px 兩種寬度下進行,並分別在減少動畫效果開關開啟和關閉的狀態下,使用 webapp-testing 技能進行測試。樣式重構前後應產生像素級別完全一致的螢幕截圖。

各項資源位置

相關技能