SwiftUI 开发助手技能

SwiftUI Agent Skill：AI 编程助手的 SwiftUI 进阶指南

这是一款面向 Claude Code、Codex、Gemini 等 AI 编程助手的 SwiftUI 技能包（Agent Skill），帮助它们写出更智能、更简洁、更现代的 SwiftUI 代码。技能涵盖 API 使用、设计、性能、无障碍访问等维度，重点解决大语言模型在实际编码中常犯的错误，包括导航、布局、动画、状态管理、VoiceOver 支持以及已废弃 API 的处理等。

适用环境为 iOS 26+ 与 Swift 6.4+。

项目动机

构建者基于数年来在 SwiftUI 真实项目中积累的经验编写而成，明确针对 LLM 的典型失误：例如让按钮对 VoiceOver 不可见、频繁使用已废弃 API、写出存在性能隐患的代码。该技能基于已有的 AGENTS.md 规范，采用 Agent Skills 格式，可无缝接入多种 AI 编码工具。

安装方法

通过 npx 一键安装到 Claude Code、Codex、Gemini、Cursor 等环境：

# 安装技能（可交互选择目标 AI 助手与作用范围）
npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro

若提示 npx: command not found，需先安装 Node：

brew install node   # 若 Homebrew 缺失，请先访问 brew.sh 安装

Claude Code 用户也可通过市场命令直接安装插件：

/plugin marketplace add twostraws/SwiftUI-Agent-Skill
/plugin install swiftui-pro@swiftui-agent-skill

Xcode 用户可参考 YouTube 教程《How to Install and Use Agent Skills in Xcode》了解图形化安装流程。

使用方式

技能名称为 swiftui-pro，在不同工具中调用语法略有差异：

# Claude Code 中调用
> /swiftui-pro

# Codex 中调用
> $swiftui-pro

支持指定专项审查范围：

/swiftui-pro Check for deprecated API          # Claude: 检查已废弃 API
$swiftui-pro Focus on accessibility            # Codex: 聚焦无障碍问题

也可使用自然语言触发整体审查，例如：

Use the SwiftUI Pro skill to look for performance problems in this project.

贡献指南

欢迎提交新的检查规则、改进现有规则或修订文档。贡献时需注意：

• 保持 Markdown 简洁，技能调用消耗 token，SKILL.md 等核心文件应严格控制篇幅；
• 不重复 LLM 已掌握的知识，重点放在边界场景、隐式行为、软废弃 API 等高价值信息；
• 所有内容须遵循 MIT 许可证。

许可证

本项目最初由 Paul Hudson（Hacking with Swift 作者）创建，以 MIT 许可证发布，允许商业使用、修改、分发与私人使用。