hig-project-context

Name: hig-project-context
Author: raintree-technology

github.com/raintree-technology设计与 UI148643 次安装6 天前更新

代码仓库

关于 hig-project-context

hig-project-context 用于创建和维护项目专属的 Apple 设计上下文文档。它从项目文件和代码中提取信息，并利用已确认的上下文辅助其他 HIG 技能，减少重复提问。

主要功能

01从项目文件和代码发现上下文
02收集产品及平台信息
03记录技术栈和设计系统选择
04整理无障碍与用户需求
05更新文档中有变化的部分

适用场景

01为 Apple HIG 指引准备项目上下文
02在设计任务间复用已确认的应用信息
03项目变更后更新上下文

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/raintree-technology/hig-doctor --skill hig-project-context

安装后在 Claude Code 中输入/hig-project-context确认已加载。

详细介绍

Apple HIG：项目上下文

创建并维护 .claude/apple-design-context.md，让其他 HIG 技能无需重复提问。

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

收集上下文

提问前，先自动发现以下信息：

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

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

1. 产品概述

App 的用途是什么？（一句话）
类别（效率、社交、健康、游戏、实用工具等）
阶段（概念、开发中、已发布、重新设计）

2. 目标平台

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

3. 技术栈

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

4. 设计系统

使用系统默认样式还是自定义设计系统？
品牌颜色、字体、图标风格？
深色模式和动态字体的支持情况

5. 无障碍要求

目标级别（基础、增强、全面）
特殊考量（VoiceOver、切换控制等）
法规要求（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
询问有哪些变化
仅更新发生变化的部分
保留所有未变更的信息