hig-components-status

hig-components-status 技能概览

hig-components-status 是一个面向状态与进度 UI 组件的 Apple HIG 指导技能：包括进度指示器、进度条、spinner、状态栏和活动环。当你需要的是设计决策，而不只是定义时，就该使用 hig-components-status，尤其适合判断确定型和不确定型反馈该怎么选、加载状态应该放在哪里，或者某个状态组件在 Apple 风格界面里应该如何表现。

最适合产品与 UI 决策

这个技能最适合设计师、PM，以及正在撰写 Apple 生态应用 UI 指南的 AI 代理。它回答的是非常实际的问题：“这里应该用哪种状态模式，为什么？”而不是生成泛泛的 UI 文案。如果你正在判断一个流程该显示进度条、spinner 还是 activity ring，hig-components-status 能更快给出有依据的建议。

这个技能的优化目标

它的核心任务，是在用户等待、追踪或完成任务时减少不确定感。它会引导你提供可见且有上下文的反馈：如果时长可预估，就展示进度；如果无法估算完成时间，就使用不确定型指示器；并且让指示器尽量靠近它所代表的内容。

它与众不同的地方

不同于一个泛泛的“加载状态”提示词，hig-components-status 的范围限定在状态组件和 HIG 相关取舍上。当你希望行为保持 Apple 风格一致时，它尤其有用，特别是在进度语义、布局位置和清晰度比视觉装饰更重要的场景里。

如何使用 hig-components-status 技能

在工作流中安装并加载

在你的技能管理器里使用 hig-components-status install 流程，或者如果你的环境支持直接添加技能，也可以从仓库路径安装。这个技能位于 skills/hig-components-status，最重要的入口文件是 SKILL.md。由于这个仓库快照里没有辅助脚本或参考文件夹，真正的价值在于仔细阅读技能文本，并直接应用其中的规则。

提供一个具体的 UI 问题

最好的 hig-components-status usage 总是从具体场景开始。好的输入会说明操作内容、进度是否可测量、状态出现在哪里，以及你正在设计哪个平台或组件。比如：“为 iPad 应用里一个 30 秒的文件上传设计带内联反馈的加载状态”就比“帮我设计 loading UI”强得多。

先读对部分

先从 SKILL.md 开始，然后提炼出适用于你场景的决策规则：何时用确定型状态、何时用不确定型状态、指示器该放在哪里，以及这个组件应该建立什么用户预期。如果你的项目里有 .claude/apple-design-context.md，在追问之前先检查它，这样技能就不会重复已有上下文。

把粗糙提示词改得更好

一个对 hig-components-status 有用的提示词，应包含：

• 任务类型：下载、上传、同步、后台处理或健身追踪
• 确定性：已知百分比、预估时长或未知时间
• 呈现位置：内联区域、工具栏、面板或全屏状态
• 用户影响：阻塞式、非阻塞式或仅提供信息
• Apple 上下文：iOS、iPadOS、macOS、watchOS 或跨平台 Apple UI

示例：“使用 hig-components-status，为 macOS 中的后台照片同步推荐合适的进度模式。同步时长不可预测，但用户应该能看出任务正在进行，且不会产生‘马上完成’的虚假期待。”

hig-components-status 技能常见问题

hig-components-status 只是一个提示词模板吗？

不是。它更像是一个面向 Apple HIG 对齐状态模式的决策指南。普通提示词也能得到答案，但 hig-components-status 能帮助你选对组件行为，避免把确定型和不确定型状态混淆。

什么时候不该用这个技能？

不要把 hig-components-status 用在通用导航、表单校验或无关的系统组件上。如果你的问题涉及手势、Widget、Complication，或者由 HealthKit 驱动的活动数据，可能有别的技能更合适。这个技能最强的场景，是设计问题明确指向状态、加载或进度反馈的时候。

对新手友好吗？

友好，前提是你已经知道自己要解决的 UI 任务。hig-components-status skill 对新手友好的原因在于，它的主要决策路径很直接：已知进度用进度条，未知时长用不确定型指示器，长任务不能让用户一直猜。

“Apple HIG” 在实践中会带来什么变化？

它会改变默认选择。hig-components-status guide 不是让你发明一个自定义加载器，而是让你的表现更符合 Apple 对清晰度、位置和感知响应速度的预期。这一点在你希望界面看起来原生、并避免用错误的状态处理误导用户时尤其重要。

如何改进 hig-components-status 技能

补齐缺失的决策输入

想从 hig-components-status for UI Design 获得更好的结果，就要说明用户在等待什么、需要多久、以及进度是否可测量。最好的做法，是用一句话讲清操作，并补上 UI 呈现位置。“同步笔记，预计时间未知，在列表行内显示反馈”就比“让它看起来在加载”有用得多。

注意最常见的失败模式

最常见的错误，是只问视觉，不定义语义。如果你不说明这个过程是确定型还是不确定型，模型很可能默认给出 spinner。如果进度可测量，就要明确说出来，并要求最可信的反馈模式。

反复打磨位置和文案

如果第一次输出显得很泛，继续补充布局约束和用户预期：指示器出现在哪里、内容能否被替换、这个状态是要安抚用户、延迟操作，还是确认完成。这些细节能帮助技能给出更有用的 Apple HIG 建议，而不是停留在宽泛的 UI 方案。

把结果当作设计评审清单

拿到第一版答案后，检查它是否真的匹配任务、是否避免了错误确定性、以及是否放在它所描述内容的附近。如果不符合，就用更窄的场景和缺失约束重新运行 hig-components-status skill。进度上下文越明确，建议通常就越可靠。