开发与工程

Swift 并发审查专家技能

让 AI 编程助手按 Swift 6.2 严格并发标准审查 async/await、actor 与任务组代码,避开大模型常犯的并发错误。

60/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 572
最近更新
5 个月前
License
MIT
swiftconcurrencyasync-awaitcode-review
+4actorstask-groupssendableswift-6

这个 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?

使用前请注意
  • 静态评审未执行任何代码;12 个 reference 文件未在证据中提供,评审核心逻辑的实际质量无法核实。
  • 发布者未经企业注册表验证,作者身份基于仓库自述(Paul Hudson),使用前请自行确认仓库完整性。
  • 技能明确面向 Swift 6.2+ 与严格并发检查,对旧版本 Swift 或非 Apple 平台项目适用性未声明。
  • 无版本历史与 changelog,Swift 6.2 相关建议可能随编译器演进而过时,请关注仓库更新。
  • 评审输出为建议性质,正确性依赖 LLM 解释,重要代码变更仍需人工复核。
开始前你需要
Agent 需要具备
  • 本地文件系统

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 只安装本技能。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/twostraws/Swift-Concurrency-Agent-Skill.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/swift-concurrency-pro/skills/swift-concurrency-pro" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • Use the Swift Concurrency Pro skill to look for potential concurrency problems in this project.

在 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 有哪些优点和局限?

优点
  • 由 Swift 并发书籍作者维护,参考内容基于一手资料而非模型通用知识
  • 明确针对 LLM 常犯的并发错误,包括模型训练数据未覆盖的 Swift 6.2 新特性
  • 不重复教授基础知识,控制 token 消耗
  • 输出格式规范:按文件列出问题、给出修改前后代码、按影响力排序总结
  • MIT 许可证,允许商用、修改和分发;明令禁止用 @unchecked Sendable 掩盖竞态
局限
  • 仅针对 Swift 6.2+ 的严格并发检查目标,旧版 Swift 项目收益有限
  • 仓库中包含 2 个技能,安装整个仓库时会引入不需要的内容
  • 源材料未提供独立的测试套件或有效性评估数据
  • 参考文件主要用英文撰写,审查结论语言取决于所用 AI 工具

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Swift 并发审查专家技能 本页 60 · 推荐 ★ 572 5 个月前 MIT
Swift 并发专家技能(Swift Concurrency Pro) 65 · 推荐 ★ 572 5 个月前 MIT
SwiftUI Pro 57 · 谨慎使用 ★ 5.9k 18 天前 MIT
SwiftUI Pro 51 · 谨慎使用 ★ 5.9k 18 天前 MIT
cmux 架构规范技能 63 · 推荐 ★ 28k 11 天前 NOASSERTION

README 明确将本技能与其姊妹技能 SwiftUI Pro、SwiftData Pro、Swift Testing Pro 并列,也指出与"罗列所有 Swift 并发知识"的技能不同——本技能只收录有实际影响的规则。通用 AI 编程助手虽具备 async/await 基础知识,但在 Swift 6.2 新特性和常见易错模式上需要此技能补充。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
60/ 100 五分制 3.0 / 5
1信任安全18 / 25 · 3.6/5

该技能为纯只读的代码评审指令,无外部副作用、无网络请求、无依赖安装、不修改系统,风险面小;作者署名(Paul Hudson)与 MIT 许可明确。扣分点:发布者未经 FollowSkills 注册表验证,reference 文件内容未在证据中呈现,无法核实其数据流与内容完整性。

2可靠稳定10 / 20 · 2.5/5

SKILL.md 内部指令自洽:12 个评审步骤结构清晰,引用路径统一使用 ${CLAUDE_SKILL_DIR},输出格式含完整示例,且有合理的部分评审降级路径。扣分点:所引用的 12 个 reference 文件未包含在证据中,关键路径无法静态验证;异常输入下的失败反馈仅靠 LLM 行为,无可控错误模式。

3适用触发11 / 15 · 3.7/5

触发条件描述明确(读写或评审 Swift 并发代码时使用),面向 Claude Code/Codex/Cursor 等多环境,安装方式文档化,支持自然语言触发和部分评审。扣分点:未声明明确的非适用边界(如 Swift 5 项目、非 Apple 平台),中文支持未提及,且核心工作流依赖本地 LLM 环境,大陆网络可达性风险低。

4规范维护11 / 15 · 3.7/5

信息架构良好:SKILL.md 主文件精简、渐进式披露到 reference 文件,符合 token 预算原则;有 author、version、license 元数据,贡献指南明确。扣分点:无 changelog,版本仅 '1.0' 无更新历史,维护责任依赖个人(Paul Hudson)无组织化治理承诺。

5有效结果6 / 15 · 2.0/5

价值主张清晰:针对 LLM 常见的 Swift 并发错误(如 @unchecked Sendable 误用、reentrancy、循环中创建 Task),示例输出可直接使用,且明确说明不重复 LLM 已知内容以节省 token。扣分点:无执行证据或第三方验证表明实际评审结果正确完整,收益声称主要基于作者经验叙述。

6证据核验4 / 10 · 2.0/5

核心规则(如 reentrancy 示例、TaskGroup 替代方案)技术正确且可被独立审计,作者有公开的 Swift 并发著作作为背景佐证。扣分点:无 CI 工作流、无提交的测试套件、无第三方执行证据覆盖技能关键路径,reference 文件内容不可见,多为作者自述式声明。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年9月10日 审查版本 bee3f69ba171 评估证据[1][2][3]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能收费吗?
不收费。技能以 MIT 许可证在 GitHub 上开源,允许商业使用、修改、分发和私人使用。
我的项目用的是 Swift 5.x,适合用吗?
技能目标为 Swift 6.2 或更高版本并假设严格并发检查,其中不少参考内容涉及 Swift 6.2 新行为;旧版项目仍可审查 actor、任务组等通用主题,但部分建议可能不适用。
除了 Claude Code 和 Codex,还能在哪些工具上用?
README 明确提到 Claude Code、Codex、Cursor 和 Gemini 等 AI 编程助手,并给出基于 npx 的通用安装方式;安装时可选择具体的目标工具和项目范围。
审查会吹毛求疵吗?会不会把 GCD 全部判为错误?
技能指令明确要求只报告真实问题、不 nitpick。GCD 在底层代码、框架互操作或性能关键的同步场景中仍是合理选择,技能不会把这类用法标记为错误。

同仓库的其他 Skills

均来自 twostraws/Swift-Concurrency-Agent-Skill

相关 Skills