laravel-filament-v5-ui-ux

Laravel Filament v5 UI/UX

Filament 5 界面的参考组合库。让 laravel-filament-v5 负责已安装版本的 API、安全性、实现和测试。

使用方法

在下方找到与你要构建的内容匹配的行，阅读对应文件，并选择 When 符合任务的组合。复制并调整模型、字段和关系。每个组合都附有其来源的官方文档和截图。

没有规定的工作流，也不要求检查截图或记录决策过程。选择合适的组合并开始构建。

如果多个组合都适用，优先选择其 Not when 描述不符合你任务的组合。如果都不适用，请说明这一点，并将该界面记录为尚未覆盖的模式，而不是自行编造组合。

路由

正在构建或重组	阅读
记录表格	references/table.md
表单或架构的页面结构 — 入口；分组、列、区块、选项卡、向导、密度	references/form-layout.md
在该结构中组合的常用表单字段 — 几何布局、标签、指导信息、状态	references/form-fields.md
在该结构中组合的集合、上传、关系或富内容控件	references/form-inputs.md
记录详情和信息列表	references/record-detail.md
运营仪表板和小组件	references/dashboard.md
面板外壳、导航、品牌、身份验证界面	references/panel-shell.md
操作、确认、覆盖层、通知、提示框、空状态	references/action-feedback.md

以上每个文件都是一组参考组合：附有来源信息、可直接复制的代码。action-feedback.md 跨界面适用，可叠加在其他任意文件之上。

这些文件是其所涵盖界面的唯一来源。

配套使用

组合是代码，因此实现工作需要使用 laravel-filament-v5 处理 API 签名、授权、安全性和测试。对于任何将上线的组合，都需要同时安装两者：

npx skills add jotafurtado/dev-skills --skill laravel-filament-v5-ui-ux --skill laravel-filament-v5

在将某个签名视为已知之前，先找到对应的同级技能。命中项必须是一个可读取的 SKILL.md，且其 frontmatter 中的 name 必须恰好为 laravel-filament-v5。按以下顺序搜索，并在首次命中时停止：

1. 此技能旁边的同级目录（../laravel-filament-v5/SKILL.md）。
2. 正在编辑的项目：先查 .agents/skills（Cursor 和 Codex），再查 .claude/skills（Claude Code）。
3. 主目录：依次查 .agents/skills、.claude/skills、.cursor/skills，然后查 .codex/skills。

仓库版本的检查脚本位于 maintenance/filament-ui-ux/scripts/discover_sibling_skill.py。已安装的此技能不包含该脚本，因此请按相同顺序读取文件。如果没有匹配文件，则没有备用的组合模块，也不能重建签名。仅调整布局的工作可以直接使用组合，但必须说明未找到同级文件。要上线代码的任务则应停止，并要求先安装上述技能。

权威依据

官方 Filament 组合优先于要求采用无关字体排印、调色板、自定义卡片系统或 CSS 优先布局的通用前端建议。仍需遵循兼容的无障碍、键盘操作、响应式、性能和 UX 文案指导。

保留既有面板主题。在编写自定义 Blade、Livewire 或 CSS 之前，说明你检查过的官方组件，以及它无法覆盖的具体缺口，并尽可能缩小自定义界面的范围。

将 API 签名、已安装版本兼容性、安全边界、实现和测试交由 laravel-filament-v5 处理。