axiom-swiftui

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SwiftUI

You MUST use this skill for ANY SwiftUI work including views, state, navigation, layout, animations, architecture, gestures, and debugging.

任何SwiftUI相关工作均需使用此技能，涵盖视图、状态、导航、布局、动画、架构、手势及调试场景。

Quick Reference

快速参考

Symptom / Task	Reference
View not updating	See `skills/debugging.md`
View update still broken after debugging	See `skills/debugging-diag.md`
Navigation issues	See `skills/nav.md`
Navigation still broken after debugging	See `skills/nav-diag.md`
Navigation API reference	See `skills/nav-ref.md`
Layout breaks on iPad/rotation	See `skills/layout.md`
Layout API reference	See `skills/layout-ref.md`
Performance/lag/slow scroll	See `skills/swiftui-performance.md`
Architecture/testability	See `skills/architecture.md`
Animation issues	See `skills/animation-ref.md`
Stacks/grids/outlines	See `skills/containers-ref.md`
Search implementation	See `skills/search-ref.md`
Gesture conflicts	See `skills/gestures.md`
iOS 26 features	See `skills/26-ref.md`

症状/任务	参考文档
视图未更新	参见 `skills/debugging.md`
调试后视图仍无法正常更新	参见 `skills/debugging-diag.md`
导航问题	参见 `skills/nav.md`
调试后导航仍异常	参见 `skills/nav-diag.md`
导航API参考	参见 `skills/nav-ref.md`
iPad/旋转时布局错乱	参见 `skills/layout.md`
布局API参考	参见 `skills/layout-ref.md`
性能卡顿/滚动缓慢	参见 `skills/swiftui-performance.md`
架构/可测试性	参见 `skills/architecture.md`
动画问题	参见 `skills/animation-ref.md`
栈/网格/大纲视图	参见 `skills/containers-ref.md`
搜索功能实现	参见 `skills/search-ref.md`
手势冲突	参见 `skills/gestures.md`
iOS 26特性	参见 `skills/26-ref.md`

Non-SwiftUI UI Routes

非SwiftUI UI场景指引

These topics are part of the broader iOS UI domain but live in separate suites:

以下主题属于iOS UI领域，但归属于其他独立技能套件：

UIKit issues

UIKit相关问题

Auto Layout conflicts → See axiom-uikit (skills/auto-layout-debugging.md)
Animation timing → See axiom-uikit (skills/uikit-animation-debugging.md)
SwiftUI ↔ UIKit bridging → See axiom-uikit (skills/uikit-bridging.md)

Auto Layout冲突 → 参见axiom-uikit（skills/auto-layout-debugging.md）
动画时序问题 → 参见axiom-uikit（skills/uikit-animation-debugging.md）
SwiftUI ↔ UIKit桥接 → 参见axiom-uikit（skills/uikit-bridging.md）

Design & guidelines

设计与规范

Liquid Glass adoption → See axiom-design (skills/liquid-glass.md)
SF Symbols → See axiom-design (skills/sf-symbols.md)
HIG compliance → See axiom-design (skills/hig.md)
Typography → See axiom-design (skills/typography-ref.md)
TextKit/rich text → See axiom-uikit (skills/textkit-ref.md)

Liquid Glass适配 → 参见axiom-design（skills/liquid-glass.md）
SF Symbols → 参见axiom-design（skills/sf-symbols.md）
HIG合规性 → 参见axiom-design（skills/hig.md）
排版 → 参见axiom-design（skills/typography-ref.md）
TextKit/富文本 → 参见axiom-uikit（skills/textkit-ref.md）

Other

其他场景

tvOS (focus, remote, text input) → See axiom-swift (skills/tvos.md)
App-level composition (root, auth, scenes) → See axiom-design (skills/app-composition.md)
Drag/drop, sharing, copy/paste → See axiom-swift (skills/transferable-ref.md)
VoiceOver, Dynamic Type →
```
/skill axiom-accessibility
```
UI test flakiness →
```
/skill axiom-testing
```
UX dead ends, dismiss traps → Launch
```
ux-flow-auditor
```
agent

tvOS（焦点、遥控器、文本输入）→ 参见axiom-swift（skills/tvos.md）
应用级组件组合（根视图、授权、场景）→ 参见axiom-design（skills/app-composition.md）
拖拽/分享/复制粘贴 → 参见axiom-swift（skills/transferable-ref.md）
VoiceOver、动态字体 →
```
/skill axiom-accessibility
```
UI测试不稳定 →
```
/skill axiom-testing
```
UX流程死胡同、关闭陷阱 → 启动
```
ux-flow-auditor
```
agent

Conflict Resolution

冲突解决

axiom-swiftui vs axiom-performance: When UI is slow (e.g., "SwiftUI List slow"):

Try axiom-swiftui FIRST — Domain-specific fixes (LazyVStack, view identity, @State optimization) often solve UI performance in 5 minutes
Only use axiom-performance if domain fixes don't help — Profiling takes longer and may confirm what domain knowledge already knows

axiom-swiftui vs axiom-performance：当UI出现卡顿（如“SwiftUI List滚动缓慢”）时：

优先使用axiom-swiftui — 领域专属修复方案（LazyVStack、视图标识、@State优化）通常能在5分钟内解决UI性能问题
仅当领域方案无效时使用axiom-performance — 性能分析耗时更长，且可能仅验证领域知识已覆盖的问题

Decision Tree

决策树

dot

digraph swiftui {
    start [label="SwiftUI issue" shape=ellipse];
    what [label="What's wrong?" shape=diamond];

    start -> what;
    what -> "skills/debugging.md" [label="view not updating"];
    what -> "skills/nav.md" [label="navigation"];
    what -> "skills/swiftui-performance.md" [label="slow/lag"];
    what -> "skills/layout.md" [label="adaptive layout"];
    what -> "skills/containers-ref.md" [label="stacks/grids/outlines"];
    what -> "skills/architecture.md" [label="feature architecture"];
    what -> "skills/animation-ref.md" [label="animations"];
    what -> "skills/gestures.md" [label="gestures"];
    what -> "skills/search-ref.md" [label="search"];
    what -> "skills/26-ref.md" [label="iOS 26 features"];
    what -> "axiom-uikit-bridging" [label="UIKit interop"];
    what -> "axiom-app-composition" [label="app-level (root, auth)"];
    what -> "axiom-transferable-ref" [label="drag/drop, sharing"];
}

dot

digraph swiftui {
    start [label="SwiftUI issue" shape=ellipse];
    what [label="What's wrong?" shape=diamond];

    start -> what;
    what -> "skills/debugging.md" [label="view not updating"];
    what -> "skills/nav.md" [label="navigation"];
    what -> "skills/swiftui-performance.md" [label="slow/lag"];
    what -> "skills/layout.md" [label="adaptive layout"];
    what -> "skills/containers-ref.md" [label="stacks/grids/outlines"];
    what -> "skills/architecture.md" [label="feature architecture"];
    what -> "skills/animation-ref.md" [label="animations"];
    what -> "skills/gestures.md" [label="gestures"];
    what -> "skills/search-ref.md" [label="search"];
    what -> "skills/26-ref.md" [label="iOS 26 features"];
    what -> "axiom-uikit-bridging" [label="UIKit interop"];
    what -> "axiom-app-composition" [label="app-level (root, auth)"];
    what -> "axiom-transferable-ref" [label="drag/drop, sharing"];
}

Automated Scanning

自动化扫描

Architecture audit → Launch
```
swiftui-architecture-auditor
```
agent

Performance scan → Launch

swiftui-performance-analyzer

agent or

/axiom:audit swiftui-performance

Navigation audit → Launch

swiftui-nav-auditor

agent or

/axiom:audit swiftui-nav

Layout audit → Launch

swiftui-layout-auditor

agent or

/axiom:audit swiftui-layout

UX flow audit → Launch
```
ux-flow-auditor
```
agent or
```
/axiom:audit ux-flow
```

Liquid Glass scan → Launch

liquid-glass-auditor

agent or

/axiom:audit liquid-glass

TextKit scan → Launch
```
textkit-auditor
```
agent or
```
/axiom:audit textkit
```

架构审计 → 启动
```
swiftui-architecture-auditor
```
agent

性能扫描 → 启动

swiftui-performance-analyzer

agent 或

/axiom:audit swiftui-performance

导航审计 → 启动

swiftui-nav-auditor

agent 或

/axiom:audit swiftui-nav

布局审计 → 启动

swiftui-layout-auditor

agent 或

/axiom:audit swiftui-layout

UX流程审计 → 启动
```
ux-flow-auditor
```
agent 或
```
/axiom:audit ux-flow
```

Liquid Glass扫描 → 启动

liquid-glass-auditor

agent 或

/axiom:audit liquid-glass

TextKit扫描 → 启动
```
textkit-auditor
```
agent 或
```
/axiom:audit textkit
```

Anti-Rationalization

误区纠正

Thought	Reality
"Simple SwiftUI layout, no need"	SwiftUI layout has 12 gotchas. `skills/layout.md` covers all of them.
"I know how NavigationStack works"	Navigation has state restoration, deep linking, and identity traps. `skills/nav.md` prevents 2-hour debugging.
"It's just a view not updating"	View update failures have 4 root causes. `skills/debugging.md` diagnoses in 5 min.
"I'll just add .animation()"	Animation issues compound. `skills/animation-ref.md` has the correct patterns.
"No architecture needed"	Even small features benefit from separation. `skills/architecture.md` prevents refactoring debt.
"I know .searchable"	Search has 6 gotchas. `skills/search-ref.md` covers all of them.

错误想法	实际情况
“只是简单的SwiftUI布局，没必要参考”	SwiftUI布局存在12个常见陷阱， `skills/layout.md` 已全部覆盖。
“我了解NavigationStack的用法”	导航涉及状态恢复、深度链接和标识陷阱， `skills/nav.md` 可避免2小时的调试工作。
“只是视图未更新而已”	视图更新失败有4种根本原因， `skills/debugging.md` 可在5分钟内完成诊断。
“我直接加个.animation()就行”	动画问题会不断叠加， `skills/animation-ref.md` 提供了正确的实现模式。
“小功能不需要架构设计”	即使是小型功能也能从职责分离中获益， `skills/architecture.md` 可避免重构债务。
“我懂.searchable的用法”	搜索功能存在6个常见陷阱， `skills/search-ref.md` 已全部覆盖。