AgentSkillsCN

ios-design-review

审查 iOS 代码，确保符合 Apple HIG 设计规范。适用于验证 SwiftUI/UIKit 代码、检查无障碍性，或对 iOS 设计实现进行审计时使用。

SKILL.md
--- frontmatter
name: ios-design-review
description: Review iOS code for Apple HIG compliance. Use when validating SwiftUI/UIKit code, checking accessibility, or auditing iOS design implementation.
version: 1.0.0

iOS Design Review

Validate SwiftUI/UIKit code against Apple Human Interface Guidelines.

When to Use

  • •After generating SwiftUI components
  • •Before submitting iOS code for review
  • •Auditing existing iOS UI code
  • •Checking accessibility compliance

Review Checklist

1. Colors & Theming

  • • Uses semantic colors (Color.primary, Color(.systemBackground))
  • • No hardcoded hex colors
  • • Works in both Light and Dark mode
  • • High contrast mode support

2. Typography

  • • Uses system fonts (San Francisco)
  • • Supports Dynamic Type
  • • Proper text styles (.headline, .body, .caption)
  • • No fixed font sizes for body text

3. Touch Targets

  • • Minimum 44×44 points for interactive elements
  • • Adequate spacing between tappable items (12-24pt)
  • • No gesture conflicts with system gestures

4. Accessibility

  • • VoiceOver labels on icon-only buttons
  • • accessibilityElement(children: .combine) for grouped content
  • • accessibilityHidden(true) for decorative elements
  • • Meaningful accessibility hints where needed

5. Navigation

  • • Tab bar for 2-5 primary destinations (not actions)
  • • Navigation titles present
  • • Back button behavior correct
  • • Modal dismiss patterns (swipe, X button)

6. SF Symbols

  • • Uses SF Symbols over custom icons where possible
  • • Correct rendering mode (monochrome/hierarchical/palette)
  • • Symbols scale with Dynamic Type

7. Layout

  • • Safe area respected
  • • Adapts to different screen sizes
  • • Proper keyboard avoidance
  • • No content clipping

Review Output Format

markdown
## HIG Compliance Review

**File:** `Views/SettingsView.swift`

### Issues Found

#### Critical
- Line 45: Touch target too small (32×32pt)
  Fix: Add `.frame(minWidth: 44, minHeight: 44)`

#### Warnings
- Line 23: Hardcoded color `Color(hex: "#FF5733")`
  Fix: Use `Color.accentColor` or semantic color

#### Suggestions
- Line 67: Consider adding accessibilityLabel to icon button

### Summary
- Critical: 1
- Warnings: 1
- Suggestions: 1
- Overall: Needs fixes before shipping

Common Issues

Color Issues

swift
// ❌ Problem
Text("Hello").foregroundColor(Color(hex: "#333333"))

// ✅ Fix
Text("Hello").foregroundStyle(.primary)

Touch Target Issues

swift
// ❌ Problem
Button { } label: {
    Image(systemName: "plus")
}

// ✅ Fix
Button { } label: {
    Image(systemName: "plus")
        .frame(minWidth: 44, minHeight: 44)
}

Accessibility Issues

swift
// ❌ Problem
Button { delete() } label: {
    Image(systemName: "trash")
}

// ✅ Fix
Button { delete() } label: {
    Image(systemName: "trash")
}
.accessibilityLabel("Delete item")

Usage

code
User: Review this SwiftUI view for HIG compliance
[pastes code]

Claude: [Runs checklist against code]
- Identifies issues by category
- Provides specific line numbers
- Suggests fixes with code examples

Related Skills

  • •ios-swiftui-generator — Generate compliant code
  • •ios-hig-reference — Full HIG reference