hwc-stimulus-fundamentals について
ライフサイクルと状態の境界が明確な Stimulus コントローラーを構築するスキルです。コントローラーの契約、コールバック、通信を整理し、DOM 処理を組み合わせやすくします。
主な機能
- 01targets、values、outlets、actions の定義
- 02ライフサイクルの設定と解除
- 03リアクティブな value コールバックの処理
- 04outlets によるコントローラー間通信
- 05DOM イベントとビジネスルールの分離
活用シーン
- 01Stimulus コントローラーの契約設計
- 02connect と disconnect の反復への対応
- 03コントローラー間通信の調整
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lucianghinda/ superpowers-ruby --skill hwc-stimulus-fundamentalsインストール後、Claude Code で/hwc-stimulus-fundamentalsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/2023-08-29-stimulus-value-changed-callbacks.md2023-10-24-stimulus-keyboardevent-101.md2023-12-05-stimulus-auto-sorting.md2023-12-19-stimulus-outlets-api.md2024-05-07-stimulus-target-callbacks.md2024-06-18-fundamentals-core-web-vitals.md2025-11-25-stimulus-web-share-api.mdINDEX.md詳細
Stimulus の基礎
明確なライフサイクルと状態の境界を備えた、堅牢な Stimulus コントローラーを実装します。
基本的なワークフロー
- コントローラーの契約を最初に定義します。ターゲット、値、アウトレット、アクション、想定されるライフサイクルを含めます。
- リアクティブな更新が必要な場合は、値のコールバックで状態遷移を管理します。
connect()の完了前に実行される可能性のあるコールバックにガードを設けます。- セットアップと破棄の対称性を保つため、
connect()/disconnect()を使用します。 - DOM イベントの処理をビジネスルールから分離し、コントローラーを組み合わせやすく保ちます。
ガードレール
- データセットを手動で解析する代わりに、宣言的なアクションパラメーターを優先します。
- コントローラー間の通信には、非公開の内部実装ではなくアウトレットを使用します。
- ターゲットのコールバックは冪等性を保ち、接続と切断が繰り返される場合を考慮します。
- DOM によるリアクティブな更新が必要な場合に限り、MutationObserver を使用します。
- UI 機能を公開する前に、ブラウザー API の対応状況を確認します。
必要なリファレンスのみを読み込む
現在のリクエストに必要なファイルのみを開きます。
- 値の変更コールバック:
references/2023-08-29-stimulus-value-changed-callbacks.md - キーボードアクションフィルターとホットキー:
references/2023-10-24-stimulus-keyboardevent-101.md - MutationObserver による並べ替え:
references/2023-12-05-stimulus-auto-sorting.md - アウトレット API による通信:
references/2023-12-19-stimulus-outlets-api.md - ターゲットコールバックのオーケストレーション:
references/2024-05-07-stimulus-target-callbacks.md - Web Share API の統合:
references/2025-11-25-stimulus-web-share-api.md - Core Web Vitals と遅延読み込みの基礎:
references/2024-06-18-fundamentals-core-web-vitals.md
全項目のカタログは references/INDEX.md を参照してください。
関連スキルへのエスカレーション
- フォーム中心の動作:
hwc-forms-validationを使用します - Turbo によるナビゲーション/履歴/キャッシュ:
hwc-navigation-contentを使用します - Turbo Stream/WebSocket のオーケストレーション:
hwc-realtime-streamingを使用します - メディアの統合と再生に関する課題:
hwc-media-contentを使用します - UX のフィードバック/トランジション/進行状況に関する課題:
hwc-ux-feedbackを使用します
コメント
Markdown 対応