スキル

Swift Concurrency Skill:まずプロジェクトの並行性を分析し、それから Swift 6 移行を語る

Agent Skills 対応のコーディングツールに Swift の並行安全性、性能、Swift 6+ 移行を調べさせたい人向け。ただし最初は分析だけし、並行モデルはまだ変えない。

公式ソース · Swift Concurrency Agent Skill

インストール

npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency

誰向けか

Swift プロジェクトを保守していて、記憶で古いスレッド API を混ぜるのではなく、専門家スキル1本で安全な並行性、性能、Swift 6+ 移行を語らせたいなら、このスキルが合う。Agent Skills オープン形式に対応する任意の AI コーディングツール向けだ。形式の説明は

https://agentskills.io/home

すでに分析できる Swift 工程があり、npx コマンド1本で swift-concurrency スキルを足すことを受け入れる必要がある。WWDC メモだけ読みたい、助手にリポジトリを読ませるつもりがない人には利点は少ない。ページはクライアント名簿付きの製品をいくつか例示しつつ「この形式を支援する任意のツール」とも書く。例を閉じた名簿だと思わないこと。

3分で最初の試行を完える

公式インストールはこの1本だ。

npx skills add https://github.com/avdlee/swift-concurrency-agent-skill --skill swift-concurrency

いまの Agent 環境にこのスキルを書き込む。手元に npx があり、ここが分析したい Swift プロジェクトの環境だと確認してから実行する。別のインストーラを並べない。

入れたら公式例で読み取り専用分析をし、まだ移行しない。

Use the swift concurrency skill and analyze the current project for Swift Concurrency improvements

成功の合図はページの How to verify に従う。助手は skills/swift-concurrency/SKILL.md の triage/playbook を引用し、あなたの誤りや作業に対応する参考ファイルへ入るべきだ。一般的な async 助言だけ出してこの playbook に触れないなら、まず止めてスキルファイルを開かせる。分析段階では actor の変更、隔離の変更、Swift 6 への引き上げを許さない。

使用例

例1:今のプロジェクトの並行改善点を調べる。前節の公式プロンプトを使う。作業は分析であり、コード変更ではない。入手できるページ本文は走査するディレクトリも報告形式も書いていない。確認できるのは、swift concurrency スキルを使ったと述べ、SKILL.md の振り分け手引きに着くこと。助言がすでに「これらのファイルを直す」になったら、先にファイル一式を出させてから決める。

例2:具体的な誤りや移行作業に対して参考ページを見る。検証手順は、あなたの error or task に対し、対応する reference file へ入ると書く。コンパイラの並行診断が既にある、または Swift 6+ 移行を明確にしたいときは、助手に先に playbook を開かせ、次に対応する参考を開かせ、言語モードはすぐ変えない。性能最適化も能力として挙がるが、性能プローブコマンドはない。性能作業も先に参考ファイルを照合する。コマンドが無いならベンチマーク脚本を発明しない。

利用上の境界

これは専門家の指導スキルであり、自動移行器ではない。安全な並行性、性能、Swift 6+ 移行は範囲内だが、最初は分析と引用で止める。リポジトリは持ち運べる Agent Plugin(spec 1.0.0)とも書かれ、対応クライアントはルートの plugin.json と skills/ からスキルを見つける。それは包装の説明であり、二本目のインストールコマンドではない。インストールは上の npx skills add だけ。

プラグイン仕様は

https://agent-plugins.org/

これを根拠に、書いていないストアインストールへ進まない。参考ファイルの完全な名簿は入手できるページ本文に無い。この材料から特定の reference を名指しできない。

最初は分析で止める。Swift 並行コードの変更、言語モードの変更、@MainActor の一括追加は、先に助手に変更ファイルと根拠の参考ページを出させ、あなたが確認してから続ける。