Communitygithub.com

リキッドガラススイッチ(Harness UI向け)

WebアプリやAIコーディングハーネスのUIに、ドラッグ可能なリキッドガラス調のセグメントスイッチを追加・適応します。2つのオプション間のビュー切り替えやモード制御に使用し、動くガラスレンズ、ドラッグ閾値、境界付き弾性オーバースクロール、平面/球面遷移を実装します。

リキッドガラススイッチ(Harness UI向け) とは?

このスキルは、AIコーディングエージェント(CodexやClaudeなど)に、WebアプリやAIコーディングハーネス向けのドラッグ可能なリキッドガラス調セグメントスイッチを実装するための手順とアセットを提供します。スイッチは2つの選択肢(例:Plane/Sphere、Global/Local)を切り替えるためのもので、連続ポインタードラッグ、70%の移動閾値でのスイッチ、20CSSピクセルのレンズオーバーハング制限、`prefers-reduced-motion`の尊重など、キーとなるインタラクション動作を保持します。ホストプロジェクトのフレームワークや状態モデルに適応するためのワークフローが定義されており、`assets/`ディレクトリには依存関係のないJavaScript/CSSファイル、デモHTML、統合ガイドが含まれています。このスキルはハーネス自体のアプリケーションチャームを変更するものではなく、ユーザーが編集可能なプロジェクトやハーネスソースに作用するよう設計されています。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lym2128094758/liquid-glass-switch/tree/HEAD/skills/liquid-glass-switch

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

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

ドキュメント

Harness UI向けリキッドガラススイッチ

このスキルは、ユーザーがパッケージ化されたガラススイッチをWebインターフェース、AIコーディングハーネス、または類似のプロジェクトUIに追加するよう依頼した場合に使用します。目的は、コンポーネントをホストプロジェクトのフレームワークと状態モデルに適応させることであり、ハーネスの無関係な部分を再設計することではありません。

このスキルをCodexまたはClaudeにインストールすると、コーディングエージェントは再利用可能な指示とコンポーネントファイルを取得しますが、それらのプロダクト自身のアプリケーションチャームを変更するためのAPIを付与するわけではありません。代わりに、ユーザーの編集可能なプロジェクトまたはハーネスソースで作業を行ってください。

ワークフロー

  1. 編集前にホストプロジェクトを検査します。UIエントリポイント、フレームワーク、既存のセグメントコントロール、状態の所有者、スタイリングアプローチ、利用可能なビルドまたはプレビューコマンドを見つけます。プロジェクトのローカルなAGENTS.md、CLAUDE.md、およびその他のプロジェクト指示に従ってください。
  2. ユーザーが切り替えたい状態のペアを特定します。このコンポーネントは正確に2つの選択肢(例:Plane/Sphere、Global/Local)のためのものです。ユーザーがより多くの選択肢を求めた場合は、パッケージ化されたコントロールはバイナリであることを説明し、要求されたインタラクションがそれでも意味をなす場合にのみ適応させてください。
  3. references/harness-porting.mdとassets/以下のファイルを読みます。DOM契約が適合する場合はassets/liquid-controls.jsとassets/liquid-controls.cssを再利用します。そうでない場合は、それらのインタラクションモデルをホストフレームワークに移植します。
  4. 選択をホストの実際の状態ソースに接続します。クリックまたはドラッグは、選択された視覚状態と表示されているビューの両方を更新する必要があります。宣言的フレームワークでは、フレームワークの背後でDOMを直接変更する代わりに、アクティブなスタイリングとaria-pressedをフレームワークの状態から導出します。
  5. キーとなるインタラクション動作を保持します:連続ポインタードラッグ、1つのジェスチャー中の方向反転の繰り返し、70%の移動閾値でのスイッチ、選択されたオプションでセトリング、レンズのオーバーハングを片側あたり最大20CSSピクセルに制限。prefers-reduced-motionを尊重します。
  6. ホストアプリがすでに.view-switch、.view-button、または.view-lensを使用している場合は、CSSセレクタのスコープを設定するか名前を変更します。ハーネスの無関係なナビゲーション、パネル、ルーティング、または永続化を変更しないでください。
  7. 利用可能なビルド、テスト、またはブラウザプレビューワークフローを使用して、実際のホストUIを検証します。マウスとタッチのドラッグ、直接ボタン起動、反転/高速ジェスチャー、リサイズ、キーボードフォーカス、低モーションを確認します。どのチェックを実行したか、およびホストハーネスの制限事項を報告します。

パッケージ化されたリソース

  • assets/liquid-controls.js:依存関係のないポインターおよびレンズアニメーション動作。
  • assets/liquid-controls.css:ライトおよびダークガラス外観。
  • assets/demo.html:スタンドアロンのブラウザ例。
  • references/harness-porting.md:フレームワークおよびハーネス統合ガイダンス。

スイッチはネイティブボタンを使用します。ホストプロジェクトは、ボタンの通常のclickイベントに応答して選択状態を変更する責任を引き続き負います。

関連スキル