swift-concurrency

swift-concurrency skill の概要

この skill でできること

swift-concurrency skill は、Swift Concurrency の問題をより少ない推測で整理・判断できるようにするためのものです。async/await へのリファクタリング、actor の isolation、Sendable、task 構造、strict concurrency の警告、Swift 6 への移行課題まで扱えます。定義の説明だけでなく、実務的なレビュー支援がほしいときに向いています。

どんな人に向いているか

次のような場合に swift-concurrency skill を使ってください。

• コードを Swift 6、またはより厳しいコンパイラチェックに移行している
• data race、actor isolation エラー、Sendable 警告を修正したい
• callback ベースの処理を async/await に置き換えたい
• @MainActor、カスタム actor、nonisolated、task group のどれを使うべきか判断したい
• リリース前にコードが concurrency-safe か確認したい

何が違うのか

この swift-concurrency skill は、結論を出すための判断重視の設計です。isolation の境界、structured concurrency、診断を変えるコンパイラ設定を重視します。同じコードでも、言語モードや toolchain 次第で「正しい」「警告が出る」「壊れている」のどれにもなり得るため、そこが重要です。

向かないケース

単に構文をさっと思い出したいだけなら、汎用プロンプトで十分なこともあります。swift-concurrency skill が特に役立つのは、答えがプロジェクトの文脈、コンパイラの挙動、実際の移行パスに左右されるときです。

swift-concurrency skill の使い方

正しい repo 文脈でインストールする

skills のセットアップでは swift-concurrency install の流れを使い、Swift コードを編集している repo に適用してください。典型的なインストールコマンドは次のとおりです。

npx skills add Joannis/claude-skills --skill swift-concurrency

環境で別の skills manager を使っている場合でも、skill slug は同じままにして、Joannis/claude-skills リポジトリを参照させてください。

入力の形を適切にする

強い swift-concurrency usage は、漠然とした話題ではなく、具体的なコード上の目的から始まります。次の情報を含めてください。

• 変更したい file や type
• compiler error か warning の本文
• 対象が Swift 5.x か Swift 6 か
• 分かっているなら関連する isolation boundary
• UI コード、server コード、共有 model コードのどれか

良い prompt:

この callback ベースの networking コードを async/await にリファクタリングしてください。ただし UI 更新は必要な箇所だけ @MainActor のままにしてください。Swift 6 を使っていて、compiler が Sendable capture を警告しています。

弱い prompt:

Swift concurrency を手伝ってください。

先に読むべき file

より速く、より安全に進めるには、まず SKILL.md を確認し、そのうえで関連性の高い reference を見てください。

• 用語の整理には references/glossary.md
• 変換パターンには references/async-await-basics.md
• isolation と actor access には references/actors.md
• capture と transfer の問題には references/sendable.md
• 並列性と contention には references/performance.md

production architecture や test を扱う場合は、references/production-patterns.md と references/testing.md も確認してください。

うまくいきやすいワークフロー

1. どの warning、error、または refactor 対象なのかを正確に特定する。
2. isolation domain を見極める: main actor、custom actor、nonisolated のどれか。
3. 単なる構文整理ではなく、structural concurrency の変更が必要か判断する。
4. まずは最小限で安全な修正を依頼する。
5. そのあとで performance、testability、Swift 6 対応の仕上げを追加依頼する。

swift-concurrency skill の FAQ

これは Swift Concurrency 用の、より良い prompt にすぎないのですか？

いいえ。swift-concurrency skill は、isolation、Sendable、移行判断を扱うための repo ベースの規約を備えた再利用可能なガイドです。答えが compiler mode や task と actor の構成に依存するなら、汎用 prompt よりも有効です。

async/await をすでに知っている必要がありますか？

いいえ。初心者でも役立ちますが、コードと error を共有できると特に効果が出ます。望む挙動しか分からない場合でも、最小限の例を渡せば、skill 側で concurrency model を組み立てられます。

server-side Swift と app code の両方で使えますか？

はい、どちらにも使えますが、助言の方向は変えるべきです。UI コードでは @MainActor が必要になることが多く、server や library code ではより狭い isolation と、Sendable や task 構造へのより慎重な配慮が必要です。

どんなときに使わないべきですか？

他言語の無関係な async API や、actor・task・compiler concurrency の観点がない純粋な business logic の問題には使わないでください。また、isolation boundary を特定できるだけの文脈を共有できない場合も、相性はよくありません。

swift-concurrency skill を改善するには

先に compiler の前提条件を伝える

品質を最も大きく上げるのは、どの language mode と toolchain を使っているかを最初に伝えることです。Swift 5.10、Swift 6、strict concurrency 設定では、答えが変わることがあります。可能なら warning の正確な文面も含めてください。

症状だけでなく境界を示す

この skill は、状態がどこにあり、誰がそれに触るのかが分かると精度が上がります。例えば次のように伝えてください。

• “This cache is shared across request tasks”
• “This view model updates UIKit state”
• “This parser should stay off the main actor”

そうすることで、swift-concurrency skill は actor isolation、nonisolated、@MainActor、task grouping のどれを選ぶべきか判断しやすくなります。

まずは最小限で安全な変更を依頼する

良い swift-concurrency guide の依頼は、きれいに compile する最小限の修正を求めます。あとで深掘りが必要なら、performance、cancellation、architecture に関する二段階目の依頼をしてください。これにより、@MainActor の一律適用や不要な Task.detached で過剰修正するのを避けられます。

書き換えではなく、次の warning で反復する

最初の回答のあとには、次の compiler diagnostic や runtime の懸念を返してください。最良の swift-concurrency for Code Editing のワークフローは段階的です。まず 1 つの isolation 問題を修正し、再 compile し、その新しい出力に基づいて Sendable、cancellation、task 構造を詰めていきます。