关于 ios-hig-design-guide
ios-hig-design-guide 是一项技能,用于依据 Apple 人机界面指南编写针对具体功能的 iOS 设计建议。它帮助设计师和产品团队筛选相关规范并整理成可执行规格,同时为主要规则标注来源路径。
主要功能
- 01同步 Apple HIG 来源页面
- 02筛选特定功能的相关指南
- 03提取无障碍与布局约束
- 04整理可执行的设计规格
- 05为主要规则标注来源路径
适用场景
- 01起草 iOS 功能规格
- 02检查无障碍和本地化要求
- 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 设计建议。
快速开始
- 同步官方资料。
- 只阅读相关章节。
- 编写针对具体功能的规格说明(不要泛泛罗列样式)。
运行:
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) 交付成果
默认输出结构:
- 功能目标和用户场景
- 信息架构和屏幕清单
- 交互和状态模型
- 组件规格说明
- 无障碍和本地化检查清单
- 待解决问题和权衡
输出风格规则
- 为每条主要规则注明来源页面路径。
- 将 HIG 指南转化为可执行的产品决策。
- 避免大段照搬原文。
- 明确标注推断出的建议。
维护
- 每当 Apple 更新 HIG 内容时,重新运行同步脚本。
- 将生成的原始文件保存在
references/中;不要手动编辑生成的输出。 - 仅在改进工作流或质量时更新此 SKILL.md。
评论
支持 Markdown