hig-foundations

hig-foundations 技能總覽

hig-foundations 是 Apple Human Interface Guidelines 的基礎決策技能，專門用在會影響清晰度、可存取性與系統一致性的早期設計判斷。當你需要針對色彩、字體、符號、材質、動效、隱私、版面、RTL 或 Apple 平台的包容性設計取得實際建議時，就該使用 hig-foundations 技能。它特別適合 UI 設計師、產品團隊，以及需要把模糊的介面想法轉成符合 Apple 風格設計決策、但不想靠猜的 agents。

hig-foundations 的用途

這個技能的重點，是在你進入畫面、元件或平台模式之前，先回答「這個東西應該長什麼樣、用起來什麼感覺？」這類問題。它在問題屬於基礎層時尤其有用，例如深色模式對比、Dynamic Type 支援、系統色彩的使用、字型選擇，或是讓圖示看起來更像原生介面。如果你的目標是讓功能對齊 Apple HIG，而不是自己發明一套視覺語言，hig-foundations 就是正確的起點。

什麼情況最適合使用

當你需要的是會跨整個 app 生效的決策，而不是單一畫面的設計時，就適合用 hig-foundations 來處理 UI Design。像是 Apple 裝置上的品牌視覺、以無障礙優先的視覺系統，或是產品規格與設計提示的基礎審查，都很適合它。若你已經需要的是很窄的互動模式，或是某個平台的實作細節，這個技能就沒那麼對題。

主要差異

hig-foundations 的價值，在於它會把你往系統預設值與考量可存取性的選擇推，而不是走向裝飾性的設計猜測。這個技能也會透過交叉引用帶你去相關的 HIG 範圍，讓你能從 foundations 進一步走到 platforms、patterns 或 components，而不用重頭開始。這也讓 hig-foundations 指南比單純的「做得像 Apple 一點」提示更實用。

如何使用 hig-foundations 技能

安裝並準備技能

使用 npx skills add raintree-technology/apple-hig-skills --skill hig-foundations 安裝。要得到最佳效果，建議把它放在 agents 能先檢視 skill 檔案與周邊脈絡、再開始撰寫建議的工作流程中。當你事先備好產品目標、目標平台與可存取性限制時，hig-foundations 的安裝與使用效果最好。

提供正確的輸入

弱的提示會說：「讓它更像 Apple。」更好的提示會說：「把 hig-foundations 套用到這個 iOS onboarding 畫面：使用系統色彩、支援 Dynamic Type、動效保持最少，並確保 CTA 在深色模式下依然清楚可讀。」請把平台、受眾、既有設計限制，以及已知問題（例如對比不足、圖示不一致或 RTL 版面）一起提供。你給的現況越具體，這個技能需要推測的地方就越少。

依這個順序閱讀原始內容

先看 SKILL.md，因為核心決策規則與交叉引用都在裡面。接著再檢查 skill 中提到的相關 repo 脈絡，尤其是 README.md、AGENTS.md、metadata.json，以及如果存在的支援資料夾。在這個 repository 裡，最關鍵的實務訊號就在 SKILL.md 本身，所以快速瀏覽那一份，通常就能判斷 hig-foundations 的用法是否符合你的任務。

產出品質更好的工作流程

把這個技能分成三步使用：先定義 UI 問題，再用平台與可存取性需求加上限制，最後請它給建議或改寫。例如：「依照 hig-foundations 檢視這個 iPad 設定頁，並提出在色彩、層級與觸控目標清晰度上的修改建議。」這樣模型就有一個具體的設計面可以評估，而不是被迫從零發明。若你是從文案或 wireframe 出發，兩者都一起提供；當文字與版面一併檢視時，基礎層的建議通常會更準確。

hig-foundations 技能 FAQ

hig-foundations 只有設計師能用嗎？

不是。hig-foundations 技能對設計師、PM、frontend engineer，以及需要 Apple 對齊 UI 方向的 agents 都有幫助。如果你在寫實作票或審查介面文案，它仍然有價值，因為很多基礎層問題同時影響程式碼與視覺。

它和一般提示詞有什麼不同？

一般提示詞可能只會提到 Apple 風格，但 hig-foundations 提供的是一個可重複使用的基礎決策框架，涵蓋系統色彩、可存取性與視覺層級等面向。這通常能減少模糊輸出，讓 hig-foundations 指南在跨畫面或跨功能重複使用時更可靠。它當然不能取代產品脈絡，但比起直接用白話說「設計好一點」，它更有規則感。

什麼情況下不該用這個技能？

如果你需要的是高度特定的互動模式、元件庫決策，或平台實作的深入拆解，就不要用 hig-foundations。這些情況下，更聚焦的技能或直接的平台指南會更快。若設計本來就已經符合 Apple 慣例，只需要小幅文案修整，也不必特別使用它。

這個技能適合初學者嗎？

適合，只要你能描述產品畫面與你想解決的問題就可以。你不需要事先熟悉所有 HIG 名詞。最好的 hig-foundations 使用方式，是用簡單、明確的提示詞，把裝置、問題與限制條件都講清楚。

如何改進 hig-foundations 技能

給出更精準的設計限制

品質提升最大的一步，是明確指出哪些東西不能改：品牌色、既有版面、支援語言，或最低可存取性目標。例如可以說：「保留目前結構，但把層級做得更像 Apple，保留品牌強調色，並通過深色模式對比。」這樣技能就能把注意力放在取捨，而不是重述顯而易見的建議。

要求做決策，不要只講原則

當你要求它做選擇時，hig-foundations 技能最強。與其說「解釋可存取性」，不如直接問「這張狀態卡適合哪些系統色彩？」或「這個動效應該減弱還是移除？」。具體的決策會產出你能立刻套用、也能快速審核的內容。

用第一版結果持續迭代

拿到第一輪回覆後，把範圍縮到最弱的部分：字體、對比、圖像語言，或版面密度。把具體失敗點回饋回去，例如「CTA 感覺太搶眼」或「內容對 Dynamic Type 來說還是太擁擠」。這種迭代方式很適合 hig-foundations，因為基礎層問題通常可以一層一層修正，效果也最穩。