mcpField
L
laravel-filament

laravel-filament

github.com/ulpi-io開発5444 回インストール9 週間前に更新
リポジトリ

laravel-filament について

laravel-filamentは、Filament v5の規約に沿って管理画面の作業を進めるスキルです。コーディングエージェントに関連資料と現行APIを参照させ、Resourceの外にビジネスロジックを置きながら、対象を絞って検証します。

主な機能

  1. 01Filament v5の規約を適用
  2. 02タスクに必要な資料だけを読み込み
  3. 03リソース、フォーム、テーブルの指針
  4. 04Resource内への業務ロジック配置を回避
  5. 05対象を絞ったテストと確認を推奨

活用シーン

  1. 01Filament CRUDリソースの作成や編集
  2. 02フォーム、テーブル、アクション、フィルターの実装
  3. 03管理画面やリソース変更の検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ulpi-io/skills --skill laravel-filament

インストール後、Claude Code で/laravel-filamentを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
actions.md
filters.md
forms.md
infolists.md
namespaces.md
notifications.md
panels.md
relationships.md
resources.md
tables.md
testing.md
widgets.md

詳細

このスキルは、Filament の作業を v5 に準拠させるためのものであり、リファレンスライブラリ全体を重複して記載するものではありません。

必ず守るルール：

  1. 最初に references/namespaces.md を読みます。
  2. 次に、タスクで実際に必要なリファレンスファイルだけを読み込みます。
  3. ビジネスロジックを Resources に置きません。
  4. 古い v3 のパターンではなく、v5 のアクション API とテーブル API を使用します。
  5. Filament の詳細なクックブックはここにインラインで記載せず、references/ に置きます。

laravel-filament

入力

  • $request：変更する Filament の管理タスクまたはコンポーネント

目標

Filament の作業を適切な v5 の規約に従って進め、正しい名前空間、テーブル API、管理パネルの構成パターンを使用した実装にします。

ステップ 0：v5 の名前空間に関する仕様を読む

必ず次のファイルから読み始めます。

  • references/namespaces.md

このファイルでは、Filament の作業で問題になりやすい名前空間と API の変更点を確認できます。

成功基準：編集前に、正しい Filament v5 の API を把握していること。

ステップ 1：関連する管理機能のリファレンスだけを読み込む

ルーティング表を使って、読むリファレンスファイルを選びます。すべてを一括で読み込まないでください。

タスク読むファイル
v5 の名前空間と API の変更references/namespaces.md
Resource（CRUD）の作成または編集references/resources.md
フォームフィールド、セクション、レイアウトreferences/forms.md
テーブルのカラム、並べ替え、検索references/tables.md
一括アクション、行アクション、ヘッダーアクションreferences/actions.md
テーブルフィルター、フィルターフォームreferences/filters.md
リレーションマネージャー、BelongsToMany、HasManyreferences/relationships.md
ダッシュボードウィジェット、統計、チャートreferences/widgets.md
複数パネルの設定、ナビゲーション、テナンシーreferences/panels.md
フラッシュメッセージ、データベース通知references/notifications.md
インフォリストのエントリー、読み取り専用ビューreferences/infolists.md
Resource、ページ、アクションのテストreferences/testing.md

複数のタスクがある場合は、複数のファイルを読みます。

成功基準：タスクに関連する Filament の規約だけが現在のコンテキストに含まれていること。

ステップ 2：Filament の基本的なガードレールに従って実装する

次のルールを常に適用します。

  • アクションには Filament\\Actions\\* を使用します。
  • テーブルには v5 のレコード／ツールバー／ヘッダーアクションのメソッドを使用します。
  • バッジの表示には TextColumn->badge() を使用します。
  • レイアウトコンポーネントには Schemas パッケージを使用します。
  • Resource クラスから、実際のビジネス処理をアプリケーションの Actions に委譲します。

成功基準：変更に有効な v5 API が使用され、保守性が保たれていること。

ステップ 3：管理画面を検証する

関連する範囲に絞って、次の検証を行います。

  • 対象を絞った機能テスト
  • Filament のページ／Resource テスト
  • リポジトリに既存のテストがある場合は、軽量な UI スモークテスト

成功基準：変更後も Filament の画面が正しく動作すること。

ガードレール

  • Filament のハンドブック全体を SKILL.md にインラインで記載しないでください。
  • references/namespaces.md を省略しないでください。
  • v3 のアクション名前空間や非推奨のテーブルメソッドを使用しないでください。
  • Resource クラスにビジネスロジックを直接記述しないでください。

リファレンスの読み込み時期

  • references/namespaces.md 必ず読みます。

  • 次に、references/ 内のタスクに関連するファイルだけを読みます。

出力仕様

次の内容を報告します。

  1. 読み込んだ Filament のリファレンス
  2. 適用した v5 のパターン
  3. 行った変更
  4. 実施した検証

コメント

Markdown 対応