hig-components-dialogs

hig-components-dialogs 技能總覽

hig-components-dialogs 是 Apple HIG 的 presentation components 技能，用來選擇與設計各種對話框，例如 alerts、action sheets、popovers、sheets 以及 digit entry views。當你需要的不是泛泛的 UI 建議，而是明確回答「我該用哪一種對話框？」時，這個技能就很有幫助。hig-components-dialogs skill 特別適合產品設計師、UI 文案撰寫者，以及需要 Apple 對齊指引的 agent 工作流程，尤其是在確認流程、破壞性操作、暫時性覆蓋層與任務導向呈現方面。

這個技能適合做什麼

當工作重點是挑對對話框樣式，並且讓它符合 Apple 平台的使用方式時，就用 hig-components-dialogs。它特別適合處理那些在設計審查中常被混淆的相近選項，例如 alert 和 sheet、popover 和 sheet、或 action sheet 和 alert 之間的取捨。

它為什麼有用

這個技能以 Apple HIG 參考資料為基礎，並圍繞實際決策點來組織：什麼時候要打斷使用者、什麼時候要保留情境、什麼時候要提供選項、以及什麼時候應避免模態摩擦。這讓 hig-components-dialogs for UI Design 比起直接掃過一遍文件，更偏向決策導向。

最適合的使用情境

這個技能很適合正在處理 iOS、iPadOS、macOS、watchOS 或 visionOS 介面的團隊，尤其是那些呈現樣式需要符合平台預期的情境。如果你的提示詞包含確認對話框、破壞性操作、覆蓋式 UI 或模態呈現考量，這個技能會是很強的對應選擇。

如何使用 hig-components-dialogs 技能

安裝並載入到上下文中

使用 npx skills add raintree-technology/apple-hig-skills --skill hig-components-dialogs 安裝。接著先讀 SKILL.md，再讀 references/ 裡連結的參考檔，讓模型先看到針對各種模式的指引，再開始撰寫 UI 文案或建議。

從具體的 UI 決策開始

hig-components-dialogs usage 在你描述動作、風險等級、平台，以及使用者是否必須立即回應時，效果最好。弱的提示詞會說「設計一個 dialog」；更強的提示詞會說「在 iPhone 上刪除共享專案時，請在 alert、sheet 或 action sheet 之間做選擇，並包含 Cancel 與一個 destructive 選項。」

先讀哪些檔案

先從 SKILL.md 開始，再查看 references/alerts.md、references/action-sheets.md、references/popovers.md、references/sheets.md 和 references/digit-entry-views.md。這些檔案涵蓋決策樹的主要分支，通常已足以避免輸出錯誤的模式。

能得到更好結果的提示詞形式

把任務目標、觸發點、使用者下一步動作，以及任何平台限制都提供給技能。例如：「一個 macOS app 需要用工具列按鈕非模態地顯示匯出選項；請建議對話框樣式並說明原因。」這比含糊的「讓它更像 Apple」更有用，因為它能讓技能把互動對應到正確的 HIG 模式。

hig-components-dialogs 技能 FAQ

hig-components-dialogs 只適用 Apple 平台嗎？

是。它以 Apple HIG 模式為核心，因此在產品需要對齊 iOS、iPadOS、macOS、watchOS 或 visionOS 時最有價值。如果你正在設計的是純 Web 的 modal 系統，這個技能就不太適合。

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

一般提示詞常會產生泛用的 modal 建議。hig-components-dialogs guide 則提供模型一個結構化、Apple 專屬的判斷框架，用來決定該用哪一種 presentation component，並避免像是過度使用 alerts、或在應該用 sheet 的地方卻用 popover 這類反模式。

初學者可以用嗎？

可以，只要能用白話描述使用者動作就行。初學者若要得到更好的結果，最好明確說出對話框出現前發生了什麼、使用者有哪些選項，以及關閉後 app 應該做什麼。

什麼情況下不該用它？

當問題是導覽、頁面版面，或不涉及對話框決策的表單欄位設計時，就不要用 hig-components-dialogs。如果你已經知道要用的確切元件，只需要一般文案撰寫，它也不是最佳選擇。

如何改進 hig-components-dialogs 技能

提供技能需要的決策輸入

提升品質最有效的方法，就是說清楚動作、緊急程度與後果。例如：「使用者要從共享文件中移除協作者；這件事可回復，但會影響其他人。」這能幫助技能避免把情境過度升級成會阻斷流程的 alert。

說明平台與互動限制

請標明畫面是 iPhone、iPad、Mac 還是 visionOS，以及觸發點是工具列、列表項目，或是內嵌控制項。這樣 hig-components-dialogs 才能區分 popover 和 sheet，並避免緊湊版面上的判斷錯誤。

留意常見失敗模式

最常見的錯誤包括：把輕量任務做成模態樣式、把例行資訊放進 alert、或讓 popover 承載過多內容。如果第一次輸出感覺太泛，請補上選項數量、是否有 destructive 操作，以及對話框是否應保留情境。

用更精準的第二次提示詞迭代

如果第一次答案接近但不夠準，可以加上更明確的限制，例如「保持非模態」、「必須支援 iPhone 單手操作」，或「只需要一次確認步驟」。這是改善 hig-components-dialogs install 成果、並得到更精準 hig-components-dialogs usage 建議的最快方式。