
关于
创建或更新共享的 Apple 设计上下文文档,供其他 HIG 技能使用以定制设计指导。
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。使用现有上下文,仅询问未涵盖的信息。
收集上下文
在提问前,从以下来源自动发现上下文:
- README.md -- 产品描述、平台目标
- Package.swift / .xcodeproj -- 支持的平台、最低 OS 版本、依赖
- Info.plist -- 应用类别、所需能力、支持的方向
- 现有代码 -- Import 语句揭示框架(SwiftUI vs UIKit、HealthKit 等)
- Assets.xcassets -- 颜色资源、图标集、深色模式变体
- 无障碍审计 -- 搜索无障碍修饰符/属性
展示发现并请用户确认或更正。然后收集仍缺失的信息:
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]
更新上下文
更新现有上下文文档时:
- 读取当前的
.claude/apple-design-context.md - 询问有什么变化
- 仅更新变更的部分
- 保留所有未变更的信息
相关技能
- hig-platforms -- 平台特定指导
- hig-foundations -- 颜色、排版、布局决策
- hig-patterns -- UX 模式建议
- hig-components-* -- 组件建议
- hig-inputs -- 输入方式覆盖
- hig-technologies -- Apple 技术相关性
由 Raintree Technology 构建 · 更多开发者工具
适用场景
此技能适用于执行概述中描述的工作流或操作。
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必要的输入、权限、安全边界或成功标准,请停下来要求澄清。
兼容工具
Claude CodeCursor
标签
AI与机器学习