ios-hig-design-guide

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

iOS HIG Design Guide

iOS HIG 设计指南

Use this skill to produce iOS design recommendations that stay close to official Apple guidance.

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

Quick start

快速开始

Sync official sources.
Read only relevant sections.
Produce a feature-specific spec (not a generic style dump).

Run:

bash

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

同步官方数据源。
仅阅读相关章节。
生成针对特定功能的规范（而非通用风格内容堆砌）。

运行：

bash

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

Source of truth

可信数据源

Full raw index with links and abstracts:
```
references/apple-hig-ios-raw.md
```
Consolidated text dump of all downloaded pages:
```
references/apple-hig-ios-fulltext.md
```
Curated text dump for iOS spec writing:
```
references/apple-hig-ios-curated.md
```
Workflow for selecting relevant HIG pages:
```
references/ios-design-spec-workflow.md
```

Per-page JSON sources:

references/raw/pages/design/human-interface-guidelines/*.json

Crawl metadata and fetch status:
```
references/raw/catalog.json
```

包含链接和摘要的完整原始索引：
```
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
```

Workflow

工作流程

1) Sync and verify

1) 同步与验证

Run sync script before answering "latest" or "current" requests.

Confirm

download_error

is 0 in

references/raw/catalog.json

If errors exist, report failed paths and continue with successfully downloaded pages.

在回答“最新”或“当前”相关请求前运行同步脚本。

确认

references/raw/catalog.json

中的

download_error

为0。

若存在错误，报告失败路径并继续使用已成功下载的页面。

2) Narrow scope

2) 缩小范围

Start from

/design/human-interface-guidelines/designing-for-ios

Add only sections directly related to the requested feature.
Prioritize foundational constraints (accessibility, layout, typography, color, writing, privacy).
Prefer
```
references/apple-hig-ios-curated.md
```
for day-to-day use; use full dump only when needed.

从

/design/human-interface-guidelines/designing-for-ios

开始。

仅添加与请求功能直接相关的章节。
优先考虑基础约束（无障碍、布局、排版、色彩、文案撰写、隐私）。
日常使用优先选择
```
references/apple-hig-ios-curated.md
```
；仅在必要时使用完整备份。

3) Extract constraints

3) 提取约束条件

For each selected page, pull concrete rules into implementable statements:

When to use component/pattern
Required states (loading, empty, error, destructive confirmation)
Accessibility behavior (labels, hints, touch target, dynamic type)
Localization/layout behavior (RTL, truncation, multiline)
Platform-specific caveats (iOS-only vs cross-platform)

针对每个选中的页面，将具体规则转化为可落地的陈述：

组件/模式的适用场景
必填状态（加载、空态、错误、破坏性操作确认）
无障碍行为（标签、提示、触摸目标、动态字体）
本地化/布局行为（RTL、截断、多行显示）
平台特定注意事项（仅iOS vs 跨平台）

4) Produce deliverable

4) 生成交付物

Default output structure:

Feature goal and user scenario
Information architecture and screen inventory
Interaction and state model
Component specification
Accessibility and localization checklist
Open questions and tradeoffs

默认输出结构：

功能目标与用户场景
信息架构与页面清单
交互与状态模型
组件规范
无障碍与本地化检查清单
待解决问题与权衡方案

Output style rules

输出风格规则

Cite source page paths for each major rule.
Translate HIG guidance into actionable product decisions.
Avoid copying large raw passages.
Mark inferred recommendations explicitly as inference.

为每条主要规则标注源页面路径。
将HIG指南转化为可执行的产品决策。
避免大段复制原始内容。
明确标记推断出的建议为“推断内容”。

Maintenance

维护

Re-run sync script whenever Apple updates HIG content.
Keep generated raw files in
```
references/
```
; do not hand-edit generated outputs.
Update this SKILL.md only for workflow or quality improvements.

每当Apple更新HIG内容时重新运行同步脚本。
将生成的原始文件保存在
```
references/
```
目录下；请勿手动编辑生成的输出内容。
仅在工作流程或质量提升时更新此SKILL.md。