SuperAPI AI 工具集

hig-project-context

设计与创作

查看项目

更新于 10-16 02:41

技能介绍

用途

hig-project-context 用于创建或更新一份共享的 Apple 设计上下文文档,供其他 HIG 技能读取,以针对性地给出设计指导,避免重复询问同一批项目背景问题。

主要能力

在提问之前,技能会先检查 .claude/apple-design-context.md 是否存在。若已存在,则使用现有上下文,只询问尚未覆盖的信息。

在提问之前,技能会从以下来源自动发现上下文:

  • README.md:产品描述、平台目标
  • Package.swift / .xcodeproj:支持的平台、最低 OS 版本、依赖
  • Info.plist:应用类别、所需能力、支持的屏幕方向
  • 现有代码:导入语句可揭示所用框架(SwiftUI 与 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,结构包含产品、平台表格、技术、设计系统、无障碍、用户等部分。平台部分以表格列出各平台是否支持、最低 OS 与备注;技术部分记录 UI 框架、架构与 Apple 技术;设计系统部分记录基础、品牌色、字体、深色模式、动态字体;无障碍部分记录目标等级与关键考虑;用户部分记录主要用户画像、关键用例与已知挑战。

更新现有上下文文档时:读取当前的 .claude/apple-design-context.md,询问有哪些变化,只更新变动的章节,保留所有未变信息。

适用场景

当任务属于上述范围,即需要为 Apple 设计相关技能建立或维护共享项目上下文时适用。

相关技能

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

限制

仅在任务明确匹配上述范围时使用本技能。不应将输出视为环境特定验证、测试或专家评审的替代。若缺少必需的输入、权限、安全边界或成功标准,应停止并请求澄清。