Communitygithub.com

steipete/swiftui-liquid-glass

SwiftUI Liquid Glass: 実装、採用、リファクタリング、正確性/パフォーマンス/デザインのレビューを行います。

swiftui-liquid-glass とは?

このスキルは、iOS 26+ で導入された Liquid Glass API(`glassEffect`、`GlassEffectContainer`、グラスボタンスタイルなど)を活用した SwiftUI 機能の実装、改善、レビューを支援します。Apple のデザインガイダンスに沿ったネイティブ API の使用を優先し、一貫性、インタラクティブ性、パフォーマンスを重視します。既存機能のレビュー、Liquid Glass を用いた改善、新機能の実装という3つのワークフローを提供し、それぞれに適した判断ツリーとチェックリストを備えています。また、`#available(iOS 26, *)` によるアベイラビリティチェックとフォールバック UI の実装を必須とし、旧バージョンとの互換性を確保します。スニペット付きのクイックリファレンスも含まれており、Claude Code などの AI エージェントが SwiftUI の Liquid Glass 関連タスクを効率的に処理できるように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swiftui-liquid-glass

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

SwiftUI Liquid Glass

帰属: @Dimillian の Dimillian/Skills よりコピー(2025-12-31)。

概要

このスキルを使用して、iOS 26+ の Liquid Glass API に完全に準拠した SwiftUI 機能を構築またはレビューします。ネイティブ API(glassEffect、GlassEffectContainer、グラスボタンスタイル)と Apple のデザインガイダンスを優先します。使用法を一貫させ、必要に応じてインタラクティブにし、パフォーマンスに配慮します。

ワークフロー判断ツリー

リクエストに応じて適切なパスを選択します:

1)既存機能のレビュー

  • Liquid Glass をどこで使用すべきか、どこで使用すべきでないかを検査します。
  • 正しいモディファイアの順序、シェイプの使用法、コンテナの配置を確認します。
  • iOS 26+ のアベイラビリティ処理と適切なフォールバックをチェックします。

2)Liquid Glass を使用した機能の改善

  • ガラス処理の対象コンポーネント(サーフェス、チップ、ボタン、カード)を特定します。
  • 複数のガラス要素が現れる場合は GlassEffectContainer を使用するようにリファクタリングします。
  • タップ可能またはフォーカス可能な要素にのみインタラクティブガラスを導入します。

3)Liquid Glass を使用した新機能の実装

  • 最初にガラスサーフェスとインタラクションを設計します(シェイプ、プロミネンス、グループ化)。
  • レイアウト/外観モディファイアの後にガラスモディファイアを追加します。
  • ビュー階層がアニメーションとともに変化する場合にのみ、モーフィングトランジションを追加します。

コアガイドライン

  • カスタムブラーよりもネイティブの Liquid Glass API を優先します。
  • 複数のガラス要素が共存する場合は GlassEffectContainer を使用します。
  • レイアウトおよびビジュアルモディファイアの後に .glassEffect(...) を適用します。
  • タッチ/ポインターに応答する要素には .interactive() を使用します。
  • 関連する要素間でシェイプを一貫させ、まとまりのある外観にします。
  • #available(iOS 26, *) でガードし、非ガラスのフォールバックを提供します。

レビューチェックリスト

  • アベイラビリティ: #available(iOS 26, *) が存在し、フォールバック UI があること。
  • 構成: 複数のガラスビューが GlassEffectContainer でラップされていること。
  • モディファイアの順序: glassEffect がレイアウト/外観モディファイアの後に適用されていること。
  • インタラクティブ性: ユーザーインタラクションが存在する場所にのみ interactive() が使用されていること。
  • トランジション: モーフィングのために @Namespace とともに glassEffectID が使用されていること。
  • 一貫性: シェイプ、ティント、スペーシングが機能全体で統一されていること。

実装チェックリスト

  • ターゲット要素と望ましいガラスのプロミネンスを定義します。
  • グループ化されたガラス要素を GlassEffectContainer でラップし、スペーシングを調整します。
  • 必要に応じて .glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...)) を使用します。
  • アクションには .buttonStyle(.glass) / .buttonStyle(.glassProminent) を使用します。
  • ビュー階層が変化する場合は、glassEffectID を使用してモーフィングトランジションを追加します。
  • 以前の iOS バージョン向けにフォールバックマテリアルとビジュアルを提供します。

クイックスニペット

これらのパターンを直接使用し、シェイプ/ティント/スペーシングを調整します。

if #available(iOS 26, *) {
    Text("Hello")
        .padding()
        .glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
    Text("Hello")
        .padding()
        .background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
}
GlassEffectContainer(spacing: 24) {
    HStack(spacing: 24) {
        Image(systemName: "scribble.variable")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
        Image(systemName: "eraser.fill")
            .frame(width: 72, height: 72)
            .font(.system(size: 32))
            .glassEffect()
    }
}
Button("Confirm") { }
    .buttonStyle(.glassProminent)

リソース

  • リファレンスガイド: references/liquid-glass.md
  • 最新の API 詳細については Apple のドキュメントを推奨します。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル