Agent Skills
› Prisma-Labs-Dev/apple-skills
› guide-swift-concurrency
guide-swift-concurrency
GitHub提供 Swift 并发编程的最佳实践与审查指南，涵盖 Actor、结构化并发、取消处理及 GCD 迁移等模式，用于确保代码正确性与符合 Swift 6.2 规范。
Trigger Scenarios
编写或审查 Swift 并发代码
调试并发相关 Bug
检查严格并发诊断错误
Install
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swift-concurrency -g -y
SKILL.md
Frontmatter
{
"name": "guide-swift-concurrency",
"type": "guide",
"origin": "https:\/\/github.com\/twostraws\/Swift-Concurrency-Agent-Skill",
"license": "MIT",
"description": "Swift concurrency patterns — actors, structured concurrency, cancellation, async streams, GCD migration, strict-concurrency diagnostics, common bug patterns. Use when writing, reviewing, or debugging concurrent Swift code."
}
Guide Skill — This is an expert workflow/pattern guide, not API reference documentation. Originally from twostraws/Swift-Concurrency-Agent-Skill by Paul Hudson. MIT License.
Swift Concurrency Patterns
Review and write Swift concurrency code for correctness, modern API usage, and adherence to project conventions. Report only genuine problems — do not nitpick or invent issues.
Core Instructions
- Target Swift 6.2 or later with strict concurrency checking.
- Prefer structured concurrency (task groups) over unstructured (
Task {}). - Prefer Swift concurrency over GCD for new code. GCD is still acceptable in low-level code, framework interop, or performance-critical synchronous work.
- Do not suggest
@unchecked Sendableto fix compiler errors — prefer actors, value types, orsendingparameters.
Review Process
- Scan for known-dangerous patterns using
references/hotspots.md. - Check for Swift 6.2 concurrency behavior using
references/new-features.md. - Validate actor usage for reentrancy and isolation using
references/actors.md. - Ensure structured concurrency is preferred using
references/structured.md. - Check unstructured task usage using
references/unstructured.md. - Verify cancellation handling using
references/cancellation.md. - Validate async stream and continuation usage using
references/async-streams.md. - Check bridging code between sync and async using
references/bridging.md. - Review legacy concurrency migrations using
references/interop.md. - Cross-check against common failure modes using
references/bug-patterns.md. - If strict-concurrency errors exist, map diagnostics to fixes using
references/diagnostics.md. - If reviewing tests, check async test patterns using
references/testing.md.
If doing partial work, load only the relevant reference files.
References
| Topic | Reference |
|---|---|
| Grep targets for code review — known-dangerous patterns | references/hotspots.md |
Swift 6.2: default isolation, @concurrent, Task.immediate, isolated deinit |
references/new-features.md |
| Actor reentrancy, global actor inference, isolation patterns | references/actors.md |
Task groups, async let, withDiscardingTaskGroup, concurrency limits |
references/structured.md |
Task vs Task.detached, when Task {} is a code smell |
references/unstructured.md |
Cooperative cancellation, withTaskCancellationHandler, broken patterns |
references/cancellation.md |
AsyncStream.makeStream(of:), continuation lifecycle, back-pressure |
references/async-streams.md |
Checked continuations, wrapping delegates, @unchecked Sendable |
references/bridging.md |
| GCD migration, Combine to AsyncSequence, completion handlers, locks | references/interop.md |
| Common concurrency failure modes LLMs produce and their fixes | references/bug-patterns.md |
| Strict-concurrency compiler errors mapped to likely fixes | references/diagnostics.md |
| Async test patterns, race detection, avoiding timing-based tests | references/testing.md |
Version History
- a76633b Current 2026-07-25 07:01
