swift-patterns

swift-patterns skill の概要

swift-patterns は何のためのものか

swift-patterns skill は、正しい state の所有、最新の navigation、整理された view の合成、ライフサイクルに沿った async 処理、実用的な performance チェックといった、Apple に寄った現在のパターンで SwiftUI の機能をレビュー、リファクタリング、構築するのに役立ちます。単なる SwiftUI の持論ではなく、実コードに対する swift-patterns guide が必要なときに最も力を発揮します。

こんな人・こんな作業に向いている

swift-patterns skill は、SwiftUI を出荷していて、コードを書き直すべきか、切り出すべきか、それとも単に直せばよいのかを判断したいときに使います。重複した state、安定しない list、旧式の navigation、重い view body 由来の回帰を減らしたい frontend チームにもよく合います。

何が違うのか

この skill は native API と保守しやすい構成を重視していますが、特定の architecture を強制しません。これは、coordinator や MVVM の押し付けではなく、実用的なレビュー支援が欲しい場合に重要です。repository は workflow と reference を中心に整理されているため、swift-patterns は一発回答向けというより、原因の切り分けと的を絞った修正に向いています。

swift-patterns skill の使い方

インストールして起動する

swift-patterns install は、skill を agent workspace に追加するという意味で使い、そのうえで具体的な SwiftUI 作業に対して呼び出します。repo の install コマンドは次のとおりです。
npx skills add efremidze/swift-patterns-skill --skill swift-patterns

適切な入力を与える

この skill は、次の情報を入れると最もよく動きます。

• 機能の目的
• 現在の SwiftUI コード、または file 名
• deployment target の詳細
• navigation、state、async behavior に関する制約
• 実際の bug、smell、または refactor の対象

弱い prompt の例: “improve this SwiftUI view.”
強い prompt の例: “Review FeedView.swift for unstable ForEach identity, duplicated loading state, and any legacy navigation APIs. Keep the current UX and target iOS 17+.”

正しい順番で repo を読む

swift-patterns usage では、まず SKILL.md を読み、次に次の順で確認します。

• references/workflows-review.md
• references/workflows-refactor.md
• references/state.md
• references/navigation.md
• references/modern-swiftui-apis.md
• references/performance.md

list、scrolling、composition を変更するなら、あわせて次も開きます。

• references/lists-collections.md
• references/scrolling.md
• references/view-composition.md
• references/refactor-playbooks.md

topic だけでなく workflow で使う

swift-patterns で最も強い結果が出るのは、作業内容を workflow に合わせたときです。

• Review: 問題点、リスクの大きさ、それぞれがなぜ重要かを聞く。
• Refactor: 段階的な rewrite 計画と、behavior を最小限に抑えた変更を求める。
• Build new feature: 最初から native pattern に沿った SwiftUI implementation を求める。

swift-patterns skill の FAQ

これは SwiftUI のレビュー専用ですか？

いいえ。swift-patterns skill は、review、refactor、新機能の作業をカバーします。とはいえ軸はあくまで SwiftUI patterns なので、出力がコードに近く、すぐ実装できる形で必要なときに最も価値があります。

普通の prompt と何が違うのですか？

普通の prompt は “best practices” を尋ねがちで、答えが広くなりやすいです。swift-patterns は state、navigation、list、concurrency、performance といった具体的な判断領域へ agent を誘導できる点が強みです。これにより試行錯誤が減り、一定の深さでレビューしたいときの swift-patterns install の判断もしやすくなります。

初心者にも向いていますか？

はい。SwiftUI を扱っていて、ガードレールが欲しい初心者には向いています。これは tutorial 用の skill ではなく、すでにコードがあり、それを直したい人向けです。ファイルを貼って、焦点を絞ったレビューを求める使い方が、初心者には特に有益です。

使わないほうがよいのはどんなときですか？

アプリ全体の architecture 論争、UIKit 中心の作業、Swift 以外の platform には使わないでください。また、repository に基づく reasoning までは不要で、短いスローガン風の答えだけ欲しい場合にも向きません。

swift-patterns skill をさらに活かす方法

制約をもっと明確にする

この skill は、platform、target OS、変えてはいけない点を明示すると精度が上がります。たとえば「iOS 16 をサポートしたまま」「coordinator は導入しない」「navigation model は変えない」といった指定です。そうすることで、実際には出荷できない modern API を勧められるのを防げます。

具体的な failure mode を指定する

弱い出力の多くは、あいまいな依頼から生まれます。よりよい入力は defect を名指しします。

• “row selection resets after deletion”
• “task restarts too often on filter changes”
• “view body is recreating formatters”
• “navigation pushes from two places”

こうすると swift-patterns は、無関係なコードを書き換えるのではなく、本当の原因に集中できます。

review から patch へ段階的に進める

最良の結果を出したいなら、まず diagnosis を求め、その後で最小限かつ安全な patch を求めます。最初の回答が state や navigation の変更を示したら、次は該当 file を明示して、修正版の implementation と tradeoff をあわせて依頼してください。ここでの swift-patterns for Frontend Development の価値は大きく、review コメントを、そのまま自信を持って適用できる code change に変えてくれます。