Swift 并发审查专家技能
让 AI 编程助手按 Swift 6.2 严格并发标准审查 async/await、actor 与任务组代码，避开大模型常犯的并发错误。
该技能为纯只读的代码评审指令，无外部副作用、无网络请求、无依赖安装、不修改系统，风险面小；作者署名（Paul Hudson）与 MIT 许可明确。扣分点：发布者未经 FollowSkills 注册表验证，reference 文件内容未在证据中呈现，无法核实其数据流与内容完整性。
SKILL.md 内部指令自洽：12 个评审步骤结构清晰，引用路径统一使用 ${CLAUDE_SKILL_DIR}，输出格式含完整示例，且有合理的部分评审降级路径。扣分点：所引用的 12 个 reference 文件未包含在证据中，关键路径无法静态验证；异常输入下的失败反馈仅靠 LLM 行为，无可控错误模式。
触发条件描述明确（读写或评审 Swift 并发代码时使用），面向 Claude Code/Codex/Cursor 等多环境，安装方式文档化，支持自然语言触发和部分评审。扣分点：未声明明确的非适用边界（如 Swift 5 项目、非 Apple 平台），中文支持未提及，且核心工作流依赖本地 LLM 环境，大陆网络可达性风险低。
信息架构良好：SKILL.md 主文件精简、渐进式披露到 reference 文件，符合 token 预算原则；有 author、version、license 元数据，贡献指南明确。扣分点：无 changelog，版本仅 '1.0' 无更新历史，维护责任依赖个人（Paul Hudson）无组织化治理承诺。
价值主张清晰：针对 LLM 常见的 Swift 并发错误（如 @unchecked Sendable 误用、reentrancy、循环中创建 Task），示例输出可直接使用，且明确说明不重复 LLM 已知内容以节省 token。扣分点：无执行证据或第三方验证表明实际评审结果正确完整，收益声称主要基于作者经验叙述。
核心规则（如 reentrancy 示例、TaskGroup 替代方案）技术正确且可被独立审计，作者有公开的 Swift 并发著作作为背景佐证。扣分点：无 CI 工作流、无提交的测试套件、无第三方执行证据覆盖技能关键路径，reference 文件内容不可见，多为作者自述式声明。
- 静态评审未执行任何代码；12 个 reference 文件未在证据中提供，评审核心逻辑的实际质量无法核实。
- 发布者未经企业注册表验证，作者身份基于仓库自述（Paul Hudson），使用前请自行确认仓库完整性。
- 技能明确面向 Swift 6.2+ 与严格并发检查，对旧版本 Swift 或非 Apple 平台项目适用性未声明。
- 无版本历史与 changelog，Swift 6.2 相关建议可能随编译器演进而过时，请关注仓库更新。
- 评审输出为建议性质，正确性依赖 LLM 解释，重要代码变更仍需人工复核。
这个 Skill 能做什么，适合哪些场景？
Swift Concurrency Pro 是 Paul Hudson 出品的一个 Agent Skill，用于审查 Swift 并发代码的正确性、现代 API 使用和常见 async/await 陷阱。它面向 Swift 6.2 及以上版本并假设开启严格并发检查，内置十二个参考文档覆盖 actor 重入、任务组、取消传播、AsyncStream、同步/异步桥接、GCD 迁移、严格并发编译器诊断和异步测试等主题。该技能强调只报告真实问题，不重复教授大模型已掌握的基础知识，专注于一手资料（作者的 Swift 并发书籍和 Swift 6.x 新特性文章）中的易错点。作者是 Hacking with Swift 的创始人，技能以 MIT 许可证开源。
技能读取时会按流程加载 ${CLAUDE_SKILL_DIR}/references/ 下的参考文件（hotspots、new-features、actors、structured、unstructured、cancellation、async-streams、bridging、interop、bug-patterns、diagnostics、testing），扫描代码中的危险并发模式；核对 Swift 6.2 新行为（默认 actor 隔离、isolated conformances、@concurrent、Task.immediate 等）；检查 actor 重入与隔离正确性；验证取消处理和 AsyncStream/continuation 用法；审查同步与异步桥接代码及遗留并发迁移；严格并发报错时将诊断映射到修复方案。输出按文件组织的问题清单，每条包含文件与行号、违反的规则和修改前后的代码示例，最后给出按影响力排序的修改建议。
- Swift 开发者在开启严格并发检查的项目中想找出 actor 重入、丢失取消传播等隐患
- 团队正在把旧项目从 GCD 或完成回调迁移到 async/await 和任务组，需要迁移审查
- 使用 Swift 6.2 新特性（默认 actor 隔离、@concurrent 等）但 AI 助手训练数据未覆盖这些内容
- 开发者编写或审查基于 Swift Testing 的异步测试，希望遵循推荐的测试模式
- 遇到 strict-concurrency 编译错误，想让 AI 把诊断信息映射为正确修复而不是用 @unchecked Sendable 糊弄
这个 Skill 有哪些优点和局限？
- 由 Swift 并发书籍作者维护，参考内容基于一手资料而非模型通用知识
- 明确针对 LLM 常犯的并发错误，包括模型训练数据未覆盖的 Swift 6.2 新特性
- 不重复教授基础知识，控制 token 消耗
- 输出格式规范：按文件列出问题、给出修改前后代码、按影响力排序总结
- MIT 许可证，允许商用、修改和分发；明令禁止用 @unchecked Sendable 掩盖竞态
- 仅针对 Swift 6.2+ 的严格并发检查目标，旧版 Swift 项目收益有限
- 仓库中包含 2 个技能，安装整个仓库时会引入不需要的内容
- 源材料未提供独立的测试套件或有效性评估数据
- 参考文件主要用英文撰写，审查结论语言取决于所用 AI 工具
如何安装这个 Skill？
Claude Code：先添加插件市场再安装插件：/plugin marketplace add twostraws/Swift-Concurrency-Agent-Skill，然后 /plugin install swift-concurrency-pro@swift-concurrency-agent-skill。Codex、Gemini、Cursor 等：运行 npx skills add https://github.com/twostraws/swift-concurrency-agent-skill --skill swift-concurrency-pro（需要 Node.js，Mac 上可用 brew install node 安装）。也可以直接克隆整个仓库手动安装；Xcode 用户可参考作者提供的安装视频。注意该仓库包含 2 个技能，npx 命令通过 --skill swift-concurrency-pro 只安装本技能。
如何使用这个 Skill？
在 Claude Code 中输入 /swift-concurrency-pro，在 Codex 中输入 $swift-concurrency-pro；可附加具体指令做部分审查，例如 /swift-concurrency-pro Help me migrate this project to task groups。也可以用自然语言触发，如"Use the Swift Concurrency Pro skill to look for potential concurrency problems in this project."。技能支持 [focus area] 参数提示，做部分审查时只加载相关参考文件。
这个 Skill 与同类方案有什么区别？
README 明确将本技能与其姊妹技能 SwiftUI Pro、SwiftData Pro、Swift Testing Pro 并列，也指出与"罗列所有 Swift 并发知识"的技能不同——本技能只收录有实际影响的规则。通用 AI 编程助手虽具备 async/await 基础知识，但在 Swift 6.2 新特性和常见易错模式上需要此技能补充。