SwiftVerify: Apple 原生应用质量验证技能 (v1.0)

> 核心任务: 确保代码达到 Apple Design Award 评审标准 (执行 ./tools/quality_gate.sh full)。

> 执行频率: 每次 Feature 完成后、PR 合并前、发布前必须执行。

技能目录结构

├── scripts/
│   ├── run_all.sh                # 入口脚本
│   ├── check_build.sh            # Step 1: 编译
│   ├── check_architecture.sh     # Step 2: 架构
│   ├── check_design_tokens.sh    # Step 3: 设计
│   ├── check_a11y.sh             # Step 4: 无障碍
│   ├── check_i18n.sh             # Step 5: 国际化
│   ├── check_performance.sh      # Step 6: 性能
│   ├── check_native.sh           # Step 7: 原生
│   └── check_tests.sh            # Step 8: 测试

## 技能拓扑图 (Topology)

graph TD

User[用户 / CI] -->|调用| RunAll[run_all.sh]

subgraph "Verification Steps"

RunAll --> Build[1. Build & Lint]

RunAll --> Arch[2. Architecture]

RunAll --> Tokens[3. Design Tokens]

RunAll --> A11y[4. Accessibility]

RunAll --> I18n[5. i18n]

RunAll --> Perf[6. Performance]

RunAll --> Native[7. Native Integration]

RunAll --> Tests[8. Unit Tests]

end

subgraph "Dependencies"

Build --> Xcode[xcodebuild]

Build --> SwiftLint[swiftlint]

Tests --> XCTest[XCTest]

Arch --> Grep[grep/awk]

end

subgraph "Rules"

RunAll -.-|quality_gate.sh| Tools[Project Tools]

end

│   ├── check_build.sh            # Step 1: 编译检查
│   ├── check_architecture.sh     # Step 2: 架构漂移检测
│   ├── check_design_tokens.sh    # Step 3: 设计系统合规
│   ├── check_a11y.sh             # Step 4: 无障碍检查
│   ├── check_i18n.sh             # Step 5: 国际化检查
│   ├── check_performance.sh      # Step 6: 性能基准 (需手动)
│   ├── check_native.sh           # Step 7: 原生集成检查
│   └── run_all.sh                # 一键执行全部检查
├── templates/
│   └── verification_report.md    # 报告模板
└── resources/
    └── ada_checklist.md          # Apple Design Award 检查清单

1. 执行流程 (Execution Protocol)

快速验证 (Quick Check)

./agent/skills/swiftverify/scripts/run_all.sh

完整验证 (Full Check)

按顺序执行以下检查，任一失败则阻断：

2. 检查详情 (Check Details)

无障碍参考

swiftverify 整合了完整的无障碍检查指南。详见 resources/accessibility-checklist.md。

自动检查项：

• ✅ VoiceOver 标签缺失检测
• ✅ 硬编码字号检测（破坏 Dynamic Type）
• ✅ Reduce Motion 适配提示
• ✅ 空标签或占位符标签检测
• ✅ 触控目标大小验证

执行检查：

./scripts/check_a11y.sh

Step 1: 编译检查 (Build Check)

文件: scripts/check_build.sh

Step 2: 架构漂移检测 (Architecture Drift)

文件: scripts/check_architecture.sh

Step 3: 设计系统合规 (Design System Compliance)

文件: scripts/check_design_tokens.sh

Step 4: 无障碍检查 (Accessibility)

文件: scripts/check_a11y.sh

Step 5: 国际化检查 (Internationalization)

文件: scripts/check_i18n.sh

Step 6: 性能检查 (Performance)

文件: scripts/check_performance.sh

> ⚠️ 性能检查需要手动运行 Instruments

Step 7: 原生集成检查 (Native Integration)

文件: scripts/check_native.sh

Step 8: 单元测试 (Unit Tests)

文件: scripts/check_tests.sh

3. 报告生成 (Report Generation)

执行完成后，在 specs/verification_report.md 生成报告：

# 验证报告 - [日期]

## 总体状态: ✅ PASS / ❌ FAIL

| 检查维度 | 状态 | 违规数 |
|----------|------|--------|
| 编译检查 | ✅ | 0 |
| 架构一致性 | ✅ | 0 |
| 设计系统 | ⚠️ | 3 |
| 无障碍 | ⚠️ | 5 |
| 国际化 | ✅ | 0 |
| 性能 | ⏳ | - |
| 原生集成 | ✅ | 0 |
| 单元测试 | ✅ | 0 |

## 违规详情
...

4. 自动修复 (Auto-Fix)

对于 SOFT 级别的违规，提供自动修复建议：

5. 与 CI/CD 集成

# GitHub Actions 示例
- name: SwiftVerify
  run: |
    chmod +x .agent/skills/swiftverify/scripts/run_all.sh
    .agent/skills/swiftverify/scripts/run_all.sh

6. 安全阻断 (Safety)

• [ ] HARD 级别失败：必须修复后才能继续
• [ ] SOFT 级别失败：可继续但需记录 Tech Debt
• [ ] INFO 级别失败：仅供参考