SwiftUI Pro
系统审查 SwiftUI 代码,发现现代 API、可维护性、无障碍与性能问题。
技能范围限于审查 SwiftUI 代码,未声明网络、文件写入或其他外部副作用,且要求不引入第三方框架而不先询问,降低了权限和依赖风险。扣分原因是未说明敏感数据处理、数据流披露、用户确认边界、回滚方式或失败后的恢复策略;作者元数据和 MIT 许可证提供了部分归属线索,但发布者身份未获验证。
审查步骤、核心规则和输出结构基本一致,引用的参考文件覆盖 API、视图、数据、导航、设计、无障碍、性能、Swift 和代码卫生。扣分原因是本次材料未提供这些参考文件,无法确认依赖可用性、规则一致性、关键路径复现或异常输入和失败反馈质量;静态审查上限也限制了评分。
目标用户和场景较清晰,涵盖 SwiftUI 项目的阅读、编写和审查,并支持按焦点进行部分审查。扣分原因是未明确非适用范围、精确触发条件、输入前提或中文语言支持;其 iOS 26、Swift 6.2 默认假设也可能不适合旧项目或非 Apple 环境。
SKILL.md 具备名称、描述、参数提示、版本、作者、许可证、分层审查流程、部分审查说明和输出示例;仓库上下文还提供安装、贡献和 MIT 许可说明。扣分原因是参考资料安装或存在性未在选定文件中自证,缺少已知限制、故障排查、变更日志、明确维护责任和更新路径。
输出要求按文件列出问题、规则、前后代码和优先级总结,示例具有直接可用性,核心任务与价值主张匹配。扣分原因是没有提交的真实审查结果、测试套件或第三方执行证据,无法确认建议的正确性、完整覆盖范围或相对手工审查的边际收益;静态校准将效果分限制在 7 分以内。
SKILL.md 对审查类别和输出格式作出可审计的明确声明,README 提供了安装和触发示例。扣分原因是参考文件内容、测试覆盖、CI 验证和独立复现证据未随材料提供,主要结论仍依赖作者声明;因此仅给予有限静态可验证性。
- 引用的 ${CLAUDE_SKILL_DIR}/references/*.md 文件未包含在本次材料中;安装后应确认这些文件存在且内容与 SKILL.md 一致。
- iOS 26 和 Swift 6.2 的默认目标可能导致旧项目被提出不适用的建议,使用前应明确项目部署目标。
- 未说明敏感代码、私有数据、网络依赖或外部工具调用的处理边界,也未提供失败恢复或回滚指导。
这个 Skill 能做什么,适合哪些场景?
SwiftUI Pro 是面向 Claude Code、Codex 及其他 AI 编程工具的 SwiftUI 代码审查技能。它针对 Swift 和 SwiftUI 项目,检查弃用 API、视图与动画、数据流、导航、设计规范、无障碍、性能、现代 Swift 以及代码整洁度。技能默认面向 iOS 26 及更高版本和 Swift 6.2 或更高版本。它适合希望让 AI 辅助开发结果更符合 Apple 平台实践的开发者,但源材料没有提供测试套件或具体项目验证结果。
读取待审查的 Swift/SwiftUI 代码,并按需读取技能目录下关于 API、视图、数据、导航、设计、无障碍、性能、Swift 和代码整洁度的参考文件。它不执行构建、测试或网络调用,而是按文件整理真实问题,标注相关代码行、违反的规则,并提供简短的修复前后示例,最后给出按影响排序的修改摘要。
- 正在开发 iOS 26+ SwiftUI 应用,希望检查是否使用了现代 API 的开发者。
- 让 AI 编写或修改 SwiftUI 后,需要审查弃用 API、视图结构和动画实现的团队。
- 需要验证 Dynamic Type、VoiceOver、Reduce Motion 和图标按钮标签的应用开发者。
- 遇到状态管理、共享数据流或导航性能问题,希望获得按文件定位建议的开发者。
- 希望在不引入 UIKit 或第三方框架的前提下维护 SwiftUI 项目的开发者。
这个 Skill 有哪些优点和局限?
- 覆盖 API 更新、视图、数据流、导航、设计、无障碍、性能和现代 Swift 等多个 SwiftUI 审查领域。
- 明确要求只报告真实问题,避免无依据的挑刺。
- 输出按文件组织,并要求提供规则名称和修复前后示例,便于实施。
- 明确面向 iOS 26+、Swift 6.2+ 和现代 Swift 并发。
- 采用 MIT 许可证,允许商业使用、修改、分发和私有使用。
- 源材料没有提供自动化测试、构建验证或项目级运行结果。
- 技能只审查 Swift/SwiftUI 代码,不应将 SwiftData、Swift Concurrency 或 Swift Testing 等独立技能的能力归入其中。
- 参考文件路径使用 CLAUDE_SKILL_DIR 变量,其他客户端需要能够正确提供技能目录上下文。
- README 没有列出完整的客户端兼容矩阵,也没有给出失败处理或权限说明。
如何安装这个 Skill?
使用 npx 安装:
npx skills add https://github.com/twostraws/swiftui-agent-skill --skill swiftui-pro
如果系统没有 npx,README 建议先运行 brew install node;如果 Homebrew 也不可用,需要先安装 Homebrew。也可以将整个仓库克隆到本地后自行安装。Claude Code 还可以运行:/plugin marketplace add twostraws/SwiftUI-Agent-Skill,然后运行 /plugin install swiftui-pro@swiftui-agent-skill。
如何使用这个 Skill?
安装后使用 SwiftUI Pro 技能。例如,在 Claude Code 中输入 /swiftui-pro,在 Codex 中输入 $swiftui-pro。也可以指定审查重点,例如“$swiftui-pro Focus on accessibility”,或使用自然语言请求检查性能问题。SKILL.md 支持通过 argument-hint 提供 focus area;更具体的安装位置和其他客户端触发方式未在源材料中完整说明。