用途:为 Filament 5.x 界面提供参考组合(composition),覆盖布局结构、视觉层级、响应式行为、主题保持的呈现方式,以及纯视觉页面。它只负责界面组合选择,不负责 API 签名、安全、实现与测试。
主要能力:按构建对象路由到对应参考文件。记录表格读 references/table.md;表单或 schema 的页面结构(入口、分组、列、区块、标签页、向导、密度)读 references/form-layout.md;结构内的日常表单字段(几何、标签、引导、状态)读 references/form-fields.md;集合、上传、关系或富内容控件读 references/form-inputs.md;记录详情与 infolist 读 references/record-detail.md;运营仪表盘与组件读 references/dashboard.md;面板外壳、导航、品牌与认证界面读 references/panel-shell.md;操作、确认、浮层、通知、提示与空状态读 references/action-feedback.md,后者跨界面叠加使用。每个组合都附带官方文档与截图来源。
使用方式:找到与任务匹配的行,读取该文件,选择 When 条件符合的组合,粘贴后按需调整模型、字段与关系。没有强制工作流,也不要求检查截图或记录决策。多个组合都合适时,优先选 Not when 不描述当前任务的那个;都不合适就说明并记录为未覆盖模式,不要临时拼凑。
配套:组合属于代码,落地实现需搭配 laravel-filament-v5 处理 API 签名、授权、安全与测试。安装命令:npx skills add jotafurtado/dev-skills --skill laravel-filament-v5-ui-ux --skill laravel-filament-v5。需按顺序查找同级 SKILL.md(../laravel-filament-v5/SKILL.md、项目内 .agents/skills 与 .claude/skills、主目录下 .agents/skills、.claude/skills、.cursor/skills、.codex/skills),首个命中即停。找不到时无回退组合模块,也不重建签名;仅排版工作可粘贴组合并说明未找到同级文件,要交付代码的任务应停下并请求安装。
限制:官方 Filament 组合优先于要求无关字体、配色、自定义卡片系统或 CSS 优先布局的通用前端建议;保留兼容的无障碍、键盘、响应式、性能与 UX 文案指导。保持既有面板主题,写自定义 Blade、Livewire 或 CSS 前须说明已检查的官方组件及其无法覆盖的具体缺口,并尽量缩小自定义范围。API 签名、版本兼容、安全边界、实现与测试交由 laravel-filament-v5。