AgentSkillsCN

hig-project-context

创建或更新一份共享的 Apple 设计上下文文档，供其他 HIG 技能参考并量身定制指导。当用户说“设置我的项目上下文”“我瞄准的是哪些平台？”“配置 HIG 设置”或在启动新的 Apple 平台项目时，可选用此技能。此外，当其他 HIG 技能需要项目上下文但尚未建立时，亦可激活此技能。此技能会生成 .claude/apple-design-context.md 文件，使 HIG 基础、HIG 平台、HIG 组件*、HIG 输入以及 HIG 技术能够在无需反复提问的情况下，为用户提供更有针对性的建议。

SKILL.md
--- frontmatter
name: hig-project-context
version: 1.0.0
description: >-
  Create or update a shared Apple design context document that other HIG skills
  use to tailor guidance. Use when the user says "set up my project context,"
  "what platforms am I targeting," "configure HIG settings," or when starting a
  new Apple platform project. Also activates when other HIG skills need project
  context but none exists yet. This skill creates .claude/apple-design-context.md
  so that hig-foundations, hig-platforms, hig-components-*, hig-inputs, and
  hig-technologies can provide targeted advice without repetitive questions.

Apple HIG: Project Context

Create and maintain .claude/apple-design-context.md so other HIG skills can skip redundant questions.

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

Gathering Context

Before asking questions, auto-discover context from:

  1. •README.md -- Product description, platform targets
  2. •Package.swift / .xcodeproj -- Supported platforms, minimum OS versions, dependencies
  3. •Info.plist -- App category, required capabilities, supported orientations
  4. •Existing code -- Import statements reveal frameworks (SwiftUI vs UIKit, HealthKit, etc.)
  5. •Assets.xcassets -- Color assets, icon sets, dark mode variants
  6. •Accessibility audit -- Grep for accessibility modifiers/attributes

Present findings and ask the user to confirm or correct. Then gather anything still missing:

1. Product Overview

  • •What does the app do? (one sentence)
  • •Category (productivity, social, health, game, utility, etc.)
  • •Stage (concept, development, shipped, redesign)

2. Target Platforms

  • •Which Apple platforms? (iOS, iPadOS, macOS, tvOS, watchOS, visionOS)
  • •Minimum OS versions
  • •Universal or platform-specific?

3. Technology Stack

  • •UI framework: SwiftUI, UIKit, AppKit, or mixed?
  • •Architecture: single-window, multi-window, document-based?
  • •Apple technologies in use? (HealthKit, CloudKit, ARKit, etc.)

4. Design System

  • •System defaults or custom design system?
  • •Brand colors, fonts, icon style?
  • •Dark mode and Dynamic Type support status

5. Accessibility Requirements

  • •Target level (baseline, enhanced, comprehensive)
  • •Specific considerations (VoiceOver, Switch Control, etc.)
  • •Regulatory requirements (WCAG, Section 508)

6. User Context

  • •Primary personas (1-3)
  • •Key use cases and environments (desk, on-the-go, glanceable, immersive)
  • •Known pain points or design challenges

7. Existing Design Assets

  • •Figma/Sketch files?
  • •Apple Design Resources in use?
  • •Existing component library?

Context Document Template

Generate .claude/apple-design-context.md using this structure:

markdown
# 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]

Updating Context

When updating an existing context document:

  1. •Read the current .claude/apple-design-context.md
  2. •Ask what has changed
  3. •Update only the changed sections
  4. •Preserve all unchanged information

Related Skills

  • •hig-platforms -- Platform-specific guidance
  • •hig-foundations -- Color, typography, layout decisions
  • •hig-patterns -- UX pattern recommendations
  • •hig-components-* -- Component recommendations
  • •hig-inputs -- Input method coverage
  • •hig-technologies -- Apple technology relevance

Built by Raintree Technology · More developer tools