---

name: hig-project-context description: 创建或更新共享的 Apple 设计上下文文档，供其他 HIG 技能使用以定制指导。 risk: unknown source: community date_added: '2026-02-27'

Apple HIG：项目上下文

创建和维护 .claude/apple-design-context.md，使其他 HIG 技能可以跳过重复问题。

在提问前检查 .claude/apple-design-context.md。使用现有上下文，仅询问未涵盖的信息。

收集上下文

在提问前，从以下来源自动发现上下文：

1. README.md -- 产品描述、平台目标
2. Package.swift / .xcodeproj -- 支持的平台、最低 OS 版本、依赖
3. Info.plist -- 应用类别、所需能力、支持的方向
4. 现有代码 -- Import 语句揭示框架（SwiftUI vs UIKit、HealthKit 等）
5. Assets.xcassets -- 颜色资源、图标集、深色模式变体
6. 无障碍审计 -- 搜索无障碍修饰符/属性

展示发现并请用户确认或更正。然后收集仍缺失的信息：

1. 产品概述

• 应用做什么？（一句话）
• 类别（效率、社交、健康、游戏、工具等）
• 阶段（概念、开发中、已上线、重新设计）

2. 目标平台

• 哪些 Apple 平台？（iOS、iPadOS、macOS、tvOS、watchOS、visionOS）
• 最低 OS 版本
• 通用还是平台特定？

3. 技术栈

• UI 框架：SwiftUI、UIKit、AppKit 还是混合？
• 架构：单窗口、多窗口、基于文档？
• 使用的 Apple 技术？（HealthKit、CloudKit、ARKit 等）

4. 设计系统

• 系统默认还是自定义设计系统？
• 品牌颜色、字体、图标风格？
• 深色模式和动态字体支持状态

5. 无障碍要求

• 目标级别（基础、增强、全面）
• 特定考虑（VoiceOver、Switch Control 等）
• 法规要求（WCAG、Section 508）

6. 用户上下文

• 主要用户画像（1-3个）
• 关键使用场景和环境（桌面、移动中、快速浏览、沉浸式）
• 已知痛点或设计挑战

7. 现有设计资源

• Figma/Sketch 文件？
• 使用 Apple Design Resources？
• 现有组件库？

上下文文档模板

使用以下结构生成 .claude/apple-design-context.md：

# Apple Design Context

## Product
- **Name**: [App name]
- **Description**: [One sentence]
- **Category**: [Category]
- **Stage**: [Concept / Development / Shipped / Redesign]

## Platforms
| Platform | Supported | Min OS | Notes |
|----------|-----------|--------|-------|
| iOS      | Yes/No    |        |       |
| iPadOS   | Yes/No    |        |       |
| macOS    | Yes/No    |        |       |
| tvOS     | Yes/No    |        |       |
| watchOS  | Yes/No    |        |       |
| visionOS | Yes/No    |        |       |

## Technology
- **UI Framework**: [SwiftUI / UIKit / AppKit / Mixed]
- **Architecture**: [Single-window / Multi-window / Document-based]
- **Apple Technologies**: [List any: HealthKit, CloudKit, ARKit, etc.]

## Design System
- **Base**: [System defaults / Custom design system]
- **Brand Colors**: [List or reference]
- **Typography**: [System fonts / Custom fonts]
- **Dark Mode**: [Supported / Not yet / N/A]
- **Dynamic Type**: [Supported / Not yet / N/A]

## Accessibility
- **Target Level**: [Baseline / Enhanced / Comprehensive]
- **Key Considerations**: [List any specific needs]

## Users
- **Primary Persona**: [Description]
- **Key Use Cases**: [List]
- **Known Challenges**: [List]

更新上下文

更新现有上下文文档时：

1. 读取当前的 .claude/apple-design-context.md
2. 询问有什么变化
3. 仅更新变更的部分
4. 保留所有未变更的信息

相关技能

• hig-platforms -- 平台特定指导
• hig-foundations -- 颜色、排版、布局决策
• hig-patterns -- UX 模式建议
• hig-components-* -- 组件建议
• hig-inputs -- 输入方式覆盖
• hig-technologies -- Apple 技术相关性

---

由 Raintree Technology 构建 · 更多开发者工具

适用场景

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停下来要求澄清。