mcpField
L
laravel-filament

laravel-filament

github.com/ulpi-io开发5444 次安装9 周前更新
代码仓库

关于 laravel-filament

laravel-filament 是一项技能，帮助按 Filament v5 规范实现管理界面任务。它引导编码 Agent 查阅相关参考资料、采用当前 API 并进行针对性验证，同时将业务逻辑留在 Resource 之外。

主要功能

  1. 01遵循 Filament v5 规范
  2. 02仅加载任务相关参考资料
  3. 03提供资源、表单和表格指导
  4. 04避免在 Resource 中处理业务逻辑
  5. 05建议针对性测试与检查

适用场景

  1. 01创建或修改 Filament 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. 使用 v5 的操作和表格 API，不要使用旧的 v3 模式。
  5. 将详尽的 Filament 指南保留在 references/ 中，不要内联到此处。

laravel-filament

输入

  • $request：要修改的 Filament 管理任务或组件

目标

按照正确的 v5 规范处理 Filament 工作，确保实现使用正确的命名空间、表格 API 和管理面板组合模式。

步骤 0：阅读 v5 命名空间约定

始终从以下文件开始：

  • references/namespaces.md

该文件说明了常见的 Filament 工作中容易出错的命名空间和 API 变更。

成功标准：编辑前，任务基于正确的 Filament v5 接口。

步骤 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
Infolist 条目、只读视图references/infolists.md
测试资源、页面、操作references/testing.md

包含多个任务？请阅读多个文件。

成功标准：当前上下文中仅包含与任务相关的 Filament 规范。

步骤 2：遵循 Filament 核心防护规则进行实现

遵守以下规则：

  • 操作来自 Filament\\Actions\\*
  • 表格使用 v5 的记录/工具栏/表头操作方法
  • 徽章展示使用 TextColumn->badge()
  • 布局组件来自 Schemas 包
  • Resource 类将实际业务工作委托给应用程序 Actions

成功标准：变更使用有效的 v5 API，且易于维护。

步骤 3：验证管理界面

采用范围最小且相关的验证方式：

  • 针对性的功能测试
  • Filament 页面/资源测试
  • 如果仓库已有轻量级 UI 冒烟测试，则使用该测试

成功标准：变更后 Filament 界面仍可正常运行。

防护规则

  • 不要将整份 Filament 手册内联到 SKILL.md 中。
  • 不要跳过 references/namespaces.md。
  • 不要使用 v3 操作命名空间或已弃用的表格方法。
  • 不要将业务逻辑直接放入 Resource 类。

何时加载参考文件

  • references/namespaces.md 始终加载。

  • 然后仅加载 references/ 下与任务相关的文件

输出约定

报告以下内容：

  1. 加载了哪些 Filament 参考文件
  2. 应用了哪种 v5 模式
  3. 所做的变更
  4. 运行的验证

评论

支持 Markdown