mcpField
R
release-review

release-review

github.com/rshankras测试与质量838516 次安装14 周前更新
代码仓库

关于 release-review

面向准备发布 macOS 和 iOS 应用的开发者，执行发布前审查。技能检查安全、隐私、UX、分发配置和 API 设计，并按优先级整理问题及修复建议。

主要功能

  1. 01安全与凭据检查
  2. 02隐私和数据收集审查
  3. 03UX 与无障碍审查
  4. 04App Store 与公证准备检查
  5. 05API 和网络处理检查
  6. 06按优先级列出问题与修复建议

适用场景

  1. 01提交 App Store 前审查应用
  2. 02公证 macOS 应用前进行检查
  3. 03发布前查找隐私或安全问题
  4. 04检查无障碍支持与错误处理

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rshankras/claude-code-apple-skills --skill release-review

安装后在 Claude Code 中输入/release-review确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

api-design-checklist.md
distribution-checklist.md
privacy-checklist.md
security-checklist.md
ux-polish-checklist.md

详细介绍

Apple 平台发布审查

从资深开发者的角度，对 macOS 和 iOS 应用进行全面的发布前审计。识别可能导致审核被拒、安全漏洞、隐私问题和用户体验问题的关键事项，并提供可执行的修复建议。

此技能的触发时机

在用户出现以下情况时使用此技能：

  • 说“审查发布”“发布审查”或“发布前审计”
  • 要求“资深开发者审查”或“关键审查”
  • 提到正在准备“App Store”“TestFlight”或“公证”
  • 想知道“高级用户可能会抱怨什么”
  • 要求“发布前审查”或“发布前检查”

审查流程

阶段 1：项目探索

首先了解项目：

# Find project type
Glob: **/*.xcodeproj or **/*.xcworkspace
Glob: **/Info.plist
Glob: **/project.pbxproj

识别：

  • 平台（macOS、iOS 或两者）
  • 应用类型（标准应用、菜单栏应用、小组件、扩展）
  • 分发方式（App Store、直接下载、TestFlight）
阶段 2：安全审查

加载并应用：security-checklist.md

重点领域：

  • 凭据存储（Keychain 模式，不硬编码机密）
  • 数据传输（HTTPS、证书验证）
  • 输入验证（防止注入）
  • 权限审计
  • 强化运行时（macOS）
阶段 3：隐私审查

加载并应用：privacy-checklist.md

重点领域：

  • 数据收集透明度
  • 隐私清单（iOS 17+）
  • 用户同意流程
  • 第三方 SDK 披露
  • GDPR 合规基础要求
阶段 4：用户体验优化审查

加载并应用：ux-polish-checklist.md

重点领域：

  • 首次启动 / 引导
  • 空状态和错误处理
  • 加载状态
  • 文本截断和无障碍功能
  • 平台专属的用户体验模式
阶段 5：分发审查

加载并应用：distribution-checklist.md

重点领域：

  • Bundle 标识符格式
  • 代码签名配置
  • Info.plist 完整性
  • 应用图标
  • 平台专属要求（公证、App Store）
阶段 6：API 设计审查

加载并应用：api-design-checklist.md

重点领域：

  • User-Agent 标头（如实标识）
  • 错误处理模式
  • 令牌过期处理
  • 速率限制
  • 离线处理

输出格式

按以下结构呈现审查结果：

# Release Review: [App Name]

**Platform**: macOS / iOS / Universal
**Distribution**: App Store / Direct Download / TestFlight
**Review Date**: [Date]

## Summary

| Priority | Count |
|----------|-------|
| Critical | X |
| High | X |
| Medium | X |
| Low | X |

---

## 🔴 Critical Issues (Must Fix)

Issues that will cause rejection, crashes, or security vulnerabilities.

### [Category]: [Issue Title]

**File**: `path/to/file.swift:123`
**Impact**: [Why this matters]

**Current Code**:
```swift
// problematic code

建议修复：

// fixed code

🟠 高优先级（应修复）

会显著影响用户体验或信任的问题。

[与上述格式相同]

🟡 中优先级（尽快修复）

应该解决但不会阻碍发布的问题。

[与上述格式相同]

🟢 低优先级 / 建议

可有可无的改进和优化。

[与上述格式相同]

✅ 优势

应用做得好的方面：

  • [优势 1]
  • [优势 2]
  • [优势 3]

建议的行动计划

  1. [关键] [首先要修复的问题]
  2. [关键] [其次要修复的问题]
  3. [高] [第三个要修复的问题] ...

## Priority Classification

### 🔴 Critical
- Security vulnerabilities (credential exposure, injection)
- Crashes or data loss scenarios
- App Store rejection causes
- Privacy violations
- Hardcoded secrets or spoofed identifiers

### 🟠 High
- Poor error handling (silent failures)
- Missing user consent or transparency
- Accessibility blockers
- Missing required Info.plist keys
- Broken functionality

### 🟡 Medium
- Incomplete onboarding
- Suboptimal UX patterns
- Missing empty states
- Performance concerns
- Minor accessibility issues

### 🟢 Low
- Code style improvements
- Additional features
- Polish and refinement
- Documentation improvements

## Platform-Specific Considerations

### macOS
- Menu bar app window activation (`NSApp.activate`)
- Sandbox exceptions justification
- Notarization requirements
- Hardened runtime
- Developer ID signing
- DMG/installer considerations

### iOS
- App Tracking Transparency
- Privacy nutrition labels
- Launch screen requirements
- Export compliance
- In-app purchase requirements
- TestFlight configuration

## References

- **security-checklist.md** - Detailed security review items
- **privacy-checklist.md** - Privacy and data handling
- **ux-polish-checklist.md** - User experience review
- **distribution-checklist.md** - Release and distribution
- **api-design-checklist.md** - Network and API patterns

评论

支持 Markdown