hig-components-dialogs

hig-components-dialogs 技能概览

hig-components-dialogs 是 Apple HIG presentation-components 技能，用于选择和设计 dialogs，例如 alerts、action sheets、popovers、sheets 和 digit entry views。它适合你需要的是清晰的“我该用哪种 dialog？”答案，而不是泛泛的 UI 提示。hig-components-dialogs skill 尤其适合产品设计师、UI 文案作者，以及需要 Apple 风格指引来处理确认流程、破坏性操作、临时浮层和任务导向型展示的 agent 工作流。

这个技能适合做什么

当任务是为 Apple 平台选择合适的 dialog 模式，并把它正确地设计出来时，用 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 和一个破坏性选项”。

先读哪些文件

先看 SKILL.md，再检查 references/alerts.md、references/action-sheets.md、references/popovers.md、references/sheets.md 和 references/digit-entry-views.md。这些文件覆盖了决策树的主要分支，通常已经足以避免输出错误的模式。

更容易出好结果的提示词结构

把任务目标、触发条件、用户下一步动作，以及任何平台限制都提供给技能。例如：“一个 macOS app 需要一种非模态方式，从工具栏按钮展示导出选项；请推荐合适的 dialog 模式并解释原因。” 这比笼统的“让它更像 Apple 风格”更有效，因为它能让技能把交互映射到正确的 HIG 模式。

hig-components-dialogs 技能 FAQ

hig-components-dialogs 只适用于 Apple 平台吗？

是的。它围绕 Apple HIG 模式构建，因此在产品需要对齐 iOS、iPadOS、macOS、watchOS 或 visionOS 时最有价值。如果你设计的是纯 Web 的 modal 系统，这个技能就不太适合。

它和普通提示词有什么不同？

普通提示词往往只会给出泛化的模态建议。hig-components-dialogs guide 给模型提供了一个结构化、Apple 专属的判断框架，用来在不同 presentation components 之间做选择，并避免过度使用 alerts、或者把 popover 用在更适合 sheet 的场景里这类反模式。

初学者可以用吗？

可以，只要能用自然语言描述用户动作即可。初学者最容易得到好结果的方式，是说清楚 dialog 出现前发生了什么、用户有哪些选项，以及关闭后 app 应该怎么处理。

什么时候不该用它？

如果问题是导航、页面布局，或者没有 dialog 决策的表单字段设计，就不要用 hig-components-dialogs。另外，如果你已经知道要用的具体组件，只是需要通用文案，这个技能也不是最合适的选择。

如何改进 hig-components-dialogs 技能

提供技能需要的决策输入

最大的质量提升，来自把动作、紧迫性和后果说清楚。例如：“用户正在把协作者从共享文档中移除；这个操作可撤销，但会影响其他人。” 这样能帮助技能避免把问题过度升级成阻断式 alert。

说明平台和交互限制

明确说明界面是在 iPhone、iPad、Mac 还是 visionOS 上，以及触发点来自工具栏、列表项还是内联控件。这样 hig-components-dialogs 就能区分 popover 和 sheet，避免在紧凑布局里出错。

注意常见失败模式

最常见的错误包括：把轻量任务做成模态模式、把常规信息放进 alert、或者让 popover 承载过多内容。如果第一次输出显得太泛泛，就补充选项数量、是否存在破坏性操作，以及 dialog 是否需要保留上下文。

用更聚焦的第二轮提示词继续迭代

如果第一次答案已经接近，但还不够准确，可以加上更具体的约束，例如“保持非模态”、“必须支持单手 iPhone 使用”，或者“只需要一步确认”。这通常是提升 hig-components-dialogs install 结果、拿到更精准 hig-components-dialogs usage 建议的最快方式。