ios-design-guidelines

ios-design-guidelines 技能概览

ios-design-guidelines 技能可以帮助你在不先通读完整源内容的情况下，对照 Apple Human Interface Guidelines 检查、调整并改写 iPhone UI 方案。它最适合 SwiftUI 和 UIKit 相关任务，尤其是布局、导航、可访问性、Dynamic Type、Dark Mode 或系统组件选择这些环节一旦出错就会直接影响结果的场景。

当你需要的是一个真实界面决策的实用指导，而不是抽象的设计理论时，就该使用这个 ios-design-guidelines 技能。它很适合设计师、iOS 工程师以及审阅代理，帮助快速揪出可避免的 HIG 问题：点击区域过小、不安全的布局、非标准导航、硬编码字号，或缺少可访问性支持。

这个技能最适合做什么

它的核心任务，是把一个粗略的 UI 想法转换成适合 iPhone 的实现方案或审查清单。这个技能最强的地方在于：当你需要 Apple 风格的默认方案、SwiftUI/UIKit 示例，以及具体的规则检查，而不是泛泛的“让它更直观”这类建议时。

它真正能带来价值的地方

当你要在常见 iOS 模式之间做选择时，它尤其有用：比如 tab bar 还是自定义导航、安全区域行为、底部固定操作、文本缩放、语义色，以及系统手势。也正因为如此，ios-design-guidelines 指南比快速扫一眼 repo 更偏决策支持。

什么时候不适合用

如果你需要的是整体产品策略、跨平台设计建议，或者 Android/web 模式，这个技能就不是合适的事实来源。它对纯视觉品牌工作也没那么有用，因为这类工作并不依赖 iOS 约定。

如何使用 ios-design-guidelines 技能

安装并先看对文件

使用 npx skills add ehmo/platform-design-skills --skill ios-design-guidelines 安装。要让 ios-design-guidelines 的安装真正发挥作用，先读 SKILL.md，再看 AGENTS.md、metadata.json 和 rules/_sections.md。这些文件会说明这个技能的适用范围、规则优先级，以及你最可能实际用到的那几组规则。

把模糊目标变成可用提示词

最好的 ios-design-guidelines 用法，始于一个具体的界面上下文。把平台、屏幕类型、用户任务和当前风险都写清楚。比如：“请审查这个面向 iPhone 的 SwiftUI 结账页面，重点看拇指区布局、安全区域、点击目标和 Dynamic Type。只建议能保留现有流程的修改。”这样技能就有了可执行的目标，而不是一个空泛的“帮我优化应用”。

什么输入最能提升输出质量

提供相关的 UI 片段、组件清单和约束条件：仅 iPhone 还是通用、SwiftUI 还是 UIKit、支持的 iOS 版本，以及任何必须保留的行为。如果你是在请求重写，请附上当前代码或界面结构，这样技能才能把规则映射到实际控件，而不是靠猜。

建议遵循的实际工作流

先做一次聚焦审查，再针对任何高风险区域做第二轮更窄的审查：比如导航、可访问性或布局。举例来说，先让它找出 HIG 违规优先级最高的问题，再只针对前三个问题给出修正版实现。这样 ios-design-guidelines 的使用更高效，修改也更容易落地。

ios-design-guidelines 技能 FAQ

这个技能只适用于 SwiftUI 吗？

不是。ios-design-guidelines 技能同时覆盖 SwiftUI 和 UIKit，因此既适合新项目，也适合旧代码重构。它的用途是把实现选择和 iPhone 规范对照，而不只是生成代码。

它和普通提示词有什么不同？

普通提示词往往只能给出表层的 UI 建议。这个技能围绕 Apple 的特定规则和常见失败模式构建，所以当你需要可审查、偏 iPhone 原生的建议，并且希望少一些猜测时，ios-design-guidelines 指南更合适。

我必须是 iOS 专家才能用吗？

不需要。只要把界面描述清楚，并提供已有的代码或布局，初学者也能用得很好。主要限制在于输入质量：如果提示词很模糊，输出也会同样模糊。

什么情况下应该避免使用它？

非 iPhone 界面、仅做品牌 mockup，或者你明确想打破标准 iOS 行为的情况，都不适合跳进来用。如果你的目标是创新交互模式，ios-design-guidelines 技能可能会正确地把你拉回系统约定。

如何改进 ios-design-guidelines 技能

给技能所需的规则上下文

想得到更好的结果，关键是先指出界面中哪些部分最可能在 HIG 审查里出问题。说明你最在意布局、导航、排版、颜色还是可访问性，这样 ios-design-guidelines 技能就能调整反馈重点，而不是把注意力摊得太散。

要求它给出修改，而不只是点评

如果你需要实现帮助，就直接要求它提供修改后的界面结构、修正后的 SwiftUI/UIKit 代码，或者一个按优先级排序的修复清单。这个技能更有价值的地方，在于它能把问题转成明确动作，比如增大点击目标、把主操作移到拇指区，或者恢复对安全区域的遵守。

注意常见的失败模式

最常见的遗漏通常是与 iOS 习惯冲突的自定义导航、无法随字号缩放的文本，以及只靠视觉状态提示、却对可访问性无效的设计。如果第一轮结果看起来过于笼统，就加入更具体的约束，比如“必须保留当前导航”或“必须支持超大 Dynamic Type”，以逼出更好的 ios-design-guidelines 使用效果。

用更窄的第二轮提示词继续迭代

拿到第一版回答后，针对最重要的风险区域重新跑一次，而不是再来一轮完整审查。比如：“现在只检查 VoiceOver、Reduce Motion 和对比度的可访问性。”这样能得到更尖锐的反馈，也能让 ios-design-guidelines 的安装在真实项目里更有价值。