关于 hig-components-status
hig-components-status 是提供 Apple HIG 状态与进度界面设计指导的技能，面向设计师和开发者。它涵盖进度指示器、状态栏和活动圆环，并给出输出建议与平台相关注意事项。
主要功能
- 01区分确定与不确定进度指示
- 02指导进度组件的位置与呈现
- 03说明状态栏样式与安全区域
- 04规范活动圆环及颜色语义
- 05提供无障碍与平台行为建议
适用场景
- 01设计下载或上传进度界面
- 02处理耗时未知的网络操作状态
- 03检查沉浸式界面的状态栏处理
- 04为活动圆环界面评估 HealthKit 与隐私要求
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/hig-components-status确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/progress-indicators.mdstatus-bars.mdactivity-rings.md详细介绍
Apple HIG：状态组件
提问前先检查 .claude/apple-design-context.md。使用现有上下文，只询问其中尚未涵盖的信息。
核心原则
进度指示器
-
对于耗时超过一两秒的操作，显示进度。
-
已知耗时或百分比时，使用确定型进度指示器。 填充式进度条能让用户清楚了解剩余工作量。用于下载、上传或任何可衡量的流程。
-
耗时未知时，使用不确定型进度指示器。 旋转指示器表明操作正在进行，但不承诺完成时间。用于不可预测的网络请求。
-
仅在进度可衡量时优先使用确定型进度。 切勿编造百分比；对于未知操作或受限的后台状态，应按照平台参考使用旋转指示器。
-
将指示器放在内容将出现的位置。 在内容区域附近内嵌显示进度，不要放在模态窗口或远处。
-
不要叠加多个指示器。 将同时进行的操作合并为一种展示，或只显示最相关的操作。
状态栏
-
没有充分理由时，不要隐藏状态栏。 仅在沉浸式体验（全屏媒体、游戏、AR）中隐藏。
-
让状态栏样式与内容相匹配。 使用浅色或深色样式，确保对比度充足。
-
遵守安全区域。 不要在状态栏后方放置交互内容。
-
退出沉浸式场景后及时恢复状态栏。
活动圆环
-
活动圆环用于活动、锻炼和站立目标。 不要将圆环隐喻用于无关数据。
-
遵守圆环颜色惯例。 红色（活动）、绿色（锻炼）、蓝色（站立）与 Apple Fitness 密切相关。
-
使用经授权的 HealthKit API 获取活动数据；尊重用户拒绝授权的决定，并保护健康数据隐私。不要根据缺少访问权限推断用户没有活动。
-
尊重用户对可选完成反馈的动作和触觉偏好。切勿伪造活动完成状态或重复系统通知。
参考索引
| 参考资料 | 主题 | 主要内容 |
|---|---|---|
| 进度指示器 | 进度条和旋转指示器 | 确定型、不确定型、内嵌位置、持续时间 |
| 状态栏 | iOS/iPadOS 状态栏 | 系统信息、可见性、样式、安全区域 |
| 活动圆环 | watchOS 活动圆环 | 活动/锻炼/站立、HealthKit、健身追踪、颜色 |
输出格式
- 指示器类型建议及理由（确定型或不确定型）。
- 时机和动画指导——持续时间阈值、动画样式、过渡效果。
- 无障碍——VoiceOver 进度播报、实时区域更新。
- 各目标平台的特定行为。
要询问的问题
- 持续时间已知还是未知？
- 涉及哪些平台？
- 操作通常需要多长时间？
- 是系统级指示器还是应用内指示器？
相关技能
- hig-components-system——显示进度或状态的小组件和复杂功能
- hig-inputs——触发进度状态的手势（下拉刷新）
- hig-technologies——用于活动圆环数据的 HealthKit；用于进度播报的 VoiceOver
由 Raintree Technology 构建 · 更多开发者工具
适用场景
当任务适用于执行概述中所述的工作流或操作时，可使用此技能。
示例
用户请求：
在此任务中使用 @hig-components-status：Apple HIG 关于状态和进度 UI 组件的指南，包括进度指示器、状态栏和活动圆环。
限制
- 仅当任务明确符合上述范围时，才使用此技能。
- 不要将输出视为针对特定环境进行验证、测试或专家评审的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。