mcpField
I
ios-hig-design-guide

ios-hig-design-guide

github.com/davepoon设计与 UI3.7k123 次安装今天更新
代码仓库

关于 ios-hig-design-guide

ios-hig-design-guide 是一项技能,用于依据 Apple 人机界面指南编写针对具体功能的 iOS 设计建议。它帮助设计师和产品团队筛选相关规范并整理成可执行规格,同时为主要规则标注来源路径。

主要功能

  1. 01同步 Apple HIG 来源页面
  2. 02筛选特定功能的相关指南
  3. 03提取无障碍与布局约束
  4. 04整理可执行的设计规格
  5. 05为主要规则标注来源路径

适用场景

  1. 01起草 iOS 功能规格
  2. 02检查无障碍和本地化要求
  3. 03审查加载、空白和错误状态

安装

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

$npx skills add https://github.com/davepoon/buildwithclaude --skill ios-hig-design-guide

安装后在 Claude Code 中输入/ios-hig-design-guide确认已加载。

附带文件references/ios-design-spec-workflow.mdscripts/sync_apple_hig_sources.py

详细介绍

iOS HIG 设计指南

使用此技能生成贴合 Apple 官方指南的 iOS 设计建议。

快速开始

  1. 同步官方资料。
  2. 只阅读相关章节。
  3. 编写针对具体功能的规格说明(不要泛泛罗列样式)。

运行:

python3 scripts/sync_apple_hig_sources.py --skill-dir .

权威来源

  • 完整原始索引及链接和摘要:references/apple-hig-ios-raw.md
  • 所有已下载页面的整合文本转储:references/apple-hig-ios-fulltext.md
  • 用于编写 iOS 规格说明的精选文本转储:references/apple-hig-ios-curated.md
  • 选择相关 HIG 页面的工作流:references/ios-design-spec-workflow.md
  • 各页面的 JSON 来源:references/raw/pages/design/human-interface-guidelines/*.json
  • 抓取元数据和获取状态:references/raw/catalog.json

工作流

1) 同步并验证
  • 回答“最新”或“当前”相关请求前,先运行同步脚本。
  • 确认 references/raw/catalog.json 中的 download_error 为 0。
  • 如果存在错误,报告获取失败的路径,并继续使用已成功下载的页面。
2) 缩小范围
  • 从 /design/human-interface-guidelines/designing-for-ios 开始。
  • 只添加与所请求功能直接相关的章节。
  • 优先考虑基础约束(无障碍、布局、排版、颜色、文案、隐私)。
  • 日常使用优先参考 references/apple-hig-ios-curated.md;仅在需要时使用完整转储。
3) 提取约束

针对每个选定页面,将具体规则提炼为可实施的陈述:

  • 何时使用组件或模式
  • 必需状态(加载、空状态、错误、破坏性操作确认)
  • 无障碍行为(标签、提示、触控目标、动态字体)
  • 本地化和布局行为(RTL、截断、多行)
  • 平台特定注意事项(仅适用于 iOS,还是跨平台)
4) 交付成果

默认输出结构:

  1. 功能目标和用户场景
  2. 信息架构和屏幕清单
  3. 交互和状态模型
  4. 组件规格说明
  5. 无障碍和本地化检查清单
  6. 待解决问题和权衡

输出风格规则

  • 为每条主要规则注明来源页面路径。
  • 将 HIG 指南转化为可执行的产品决策。
  • 避免大段照搬原文。
  • 明确标注推断出的建议。

维护

  • 每当 Apple 更新 HIG 内容时,重新运行同步脚本。
  • 将生成的原始文件保存在 references/ 中;不要手动编辑生成的输出。
  • 仅在改进工作流或质量时更新此 SKILL.md。

评论

支持 Markdown