尧图网站建设 
Filament AI 辅助开发指南用 Laravel Boost Agent Skills 与 Blueprint 规划流编写地道框架代码【免费下载链接】filamentA powerful open-source UI framework for Laravel • Build and ship apps admin panels fast with Livewire项目地址: https://gitcode.com/GitHub_Trending/fi/filament本文基于 Filament 官方文档的 AI 辅助开发章节展开讲解在 Filament 项目中引入 AI 编码代理的完整工作流安装 Laravel Boost 并启用 Filament 官方提供的 Agent Skill、用付费扩展 Filament Blueprint 为复杂功能生成精确的实施方案Blueprint、以及调用内置安全审计技能对面板做安全体检。读完后你应能配置好让 AI 代理写出符合框架约定代码的开发环境掌握规划代理 实现代理的分阶段开发模式并验证每一步安装产物。背景为什么 AI 代理需要Filament 专项训练Claude Code、Cursor、GitHub Copilot 等 AI 编码代理可以显著加速 Filament 开发但通用模型对框架的约定组件命名空间、布局默认值、测试写法并不天然了解容易生成看起来像、跑起来错的代码。Filament 的解法是向 Laravel Boost 提供一个Agent Skill它教会 AI 代理如何编写地道的 Filament 代码并遵循框架约定Laravel Boost 甚至允许代理在遇到不熟悉的需求时检索 Filament 官方文档获取答案。本页内容参考了 Laravel 官方的 AI 辅助开发文档。Laravel Boost 由 Laravel 团队开发其可用工具、文档检索与 IDE 集成等细节可查阅 Laravel 官方 AI 文档。安装 Laravel Boost 并启用 Filament Agent Skill将 Boost 作为开发依赖安装composer require laravel/boost --dev然后运行交互式安装器依次选择Agent Skills再选择filament/filament (skills)php artisan boost:install安装器会自动检测你使用的 IDE 和 AI 代理并生成相应的配置文件。验证方式检查你的代理的 skills 目录中是否存在filament-development/SKILL.md。注意如果你是在 Filament 提供 Agent Skill 之前安装的 Boost需要重新运行php artisan boost:install并选择Agent Skills才能启用单独运行php artisan boost:update并不会开启新功能。源码级实证仓库中自带的 filament-development Skill在当前 Filament 仓库中这个 Agent Skill 的真实内容就存放在 filament-development/SKILL.md随 panels 包一同分发。文档中提到的在代理 skills 目录检查filament-development/SKILL.md对应的正是安装器把这个技能文件写入你本地代理的 skills 目录。该 Skill 的 frontmatter 定义如下SKILL.mdname: filament-development description: Builds Filament application and admin panel interfaces. Use when creating, modifying, testing, or debugging Filament panels, resources, relation managers, pages, schemas, forms, tables, actions, infolists, widgets, imports, or exports.也就是说代理在创建、修改、测试、调试面板、资源、关系管理器、页面、Schema、表单、表格、操作、信息列表、部件、导入导出等场景下会触发该技能。从源码内容看Skill 教会代理的要点可以分为五类1. 使用官方文档检索。Skill 指示代理优先使用search-docs工具查询 Artisan 命令、代码示例、测试、关系与惯用写法——这印证了文档中Boost 允许代理检索 Filament 文档的说法同时要求始终使用 Filament 专属的 Artisan 命令创建文件并在运行前先检查可用选项、始终传递--no-interaction。2. 核心编码模式。Skill 给出了一批从源码结构看确实如此的可运行范式且与仓库实现一一对应用Get $get/Set $set实现字段间条件联动。这两个工具类确实存在于 packages/schemas/src/Components/Utilities/Get.php 与 Set.phpuse Filament\Forms\Components\Select; use Filament\Forms\Components\TextInput; use Filament\Schemas\Components\Utilities\Get; Select::make(type) -options(CompanyType::class) -required() -live(), TextInput::make(company_name) -required() -visible(fn (Get $get): bool $get(type) business),在-live()字段的-afterStateUpdated()中用Set做响应式更新文本输入优先-live(onBlur: true)以避免逐键触发布局用SectionGrid嵌套子组件默认占一列跨列用-columnSpan()/-columnSpanFull()Repeater::make(...)-relationship()无参绑定与字段同名的HasMany关系表格计算列用TextColumn::make(full_name)-state(fn (User $record) ...)筛选用SelectFilter枚举/关系与Filter::make()-query()自定义查询操作Action是按钮 可选模态表单 行为的封装。3. 命名空间精确清单。Skill 明确列出了各组件的正确命名空间表单字段在Filament\Forms\Components\、信息列表条目在Filament\Infolists\Components\、布局组件在Filament\Schemas\Components\、工具类在Filament\Schemas\Components\Utilities\、表格列在Filament\Tables\Columns\、筛选器在Filament\Tables\Filters\、操作统一在Filament\Actions\特别强调不要用Filament\Tables\Actions\或Filament\Forms\Actions\、图标用Filament\Support\Icons\Heroicon枚举。这正是文档所说覆盖代理常写错的细节命名空间、方法名、组件选择的落点。4. 常见错误清单。包括文件可见性默认private需要公开访问必须显式-visibility(public)Grid/Section/Fieldset/Repeater默认不占满整行不存在BelongsToSelectBelongsTo字段应使用Select::make(author_id)-relationship(author, name)Repeater用-schema()而非-fields()不要在需要保存的字段上加-dehydrated(false)覆写Page/Resource/Widget属性时保留联合类型如$navigationIcon是string | BackedEnum | null而非?string。5. 测试规范。Skill 给出基于 Pest Livewire 的完整测试范式测试面板功能前必须$this-actingAs(User::factory()-create())编辑页传[record $user-id]且调用-call(save)而非create表格测试用assertCanSeeTableRecords()/searchTable()验证失败断言用assertHasFormErrors()触发操作用-callAction(TestAction::make(name)-table($record))。另外值得一提本仓库根目录还有一份 AGENTS.md它面向直接在该框架仓库内工作的编码代理规定了变量命名、Pest 测试命名、流式 API、容器解析与可扩展性等约定。从文件职责划分看AGENTS.md服务的是框架自身的开发协作而filament-developmentSkill 服务的是终端用户应用——两者共同体现了把约定写成机器可读文件这一 AI 辅助开发实践。Filament Blueprint把规划与实现分离Filament 官方 Skill 主要面向实现型代理当代理已经知道要做什么时帮它写出正确的 Filament 代码。但 AI 生成代码的质量高度依赖计划的质量——实现代理拿到清晰、详尽的规格说明后可以把全部精力放在写对代码上而不是猜测需求或臆测意图。对复杂功能而言代理在规划阶段往往力不从心选错组件、关系结构设计不佳、想不全边界情况。模糊的计划导致模糊的代码最终你会花比节省下来更多的时间去纠正代理。Filament Blueprint 是一款付费premium扩展帮助 AI 代理为 Filament 生成准确、详尽的实施方案兼容 Filament v4 及以上版本。它的作用是填补你想要的与代理实际构建的之间的差距与其指望代理理解 Filament 约定不如用一个结构化的规划技能产出无歧义的规格文档。一份 Blueprint 会写明实现代理需要的一切模型Models属性、casts、关系、带精确语法的枚举资源Resources完整命名空间、脚手架命令、配置表单Forms字段组件、验证规则、布局结构表格Tables列、筛选器、操作、排序行为授权Authorization可直接翻译为代码的英文策略规则测试Testing测试什么、如何验证可用更多响应式字段、向导wizards、导入/导出、批量操作、部件、多租户等规划技能覆盖了代理常写错的细节命名空间、方法名、组件选择、嵌套布局计算让实现代理可以一次写对。同时该规划技能只面向规划代理不会占用实现代理的上下文窗口规划代理会把所有必要细节命名空间、需要抓取的文档 URL、精确方法语法直接复制进 Blueprint 本身实现代理无需再加载规划技能即可拿到全部信息。安装 BlueprintBlueprint 兼容 Filament v4 及以上版本。先为 Blueprint 购买许可证通过 Filament Packages 门户然后用 Composer 安装composer config repositories.filament composer https://packages.filamentphp.com/composer composer config --auth http-basic.packages.filamentphp.com YOUR_EMAIL_ADDRESS YOUR_LICENSE_KEY composer require filament/blueprint --dev接着运行 Boost 安装器选择Agent Skills再选择filament/blueprint (skills)php artisan boost:install验证方式在代理的 skills 目录中检查是否存在planning-filament/SKILL.md和filament-security-audit/SKILL.md。要访问已购买的许可证请使用购买 Blueprint 时的邮箱登录 Filament Packages 门户。使用 Blueprint规划模式生成实施方案要创建 Blueprint在你的 AI 代理中开启规划模式planning mode并要求它使用planning-filament技能。官方文档给出的示例提示词Using the planning-filament skill, create a Filament Blueprint for an order management system. Orders belong to customers and have many order items. Each order has a status (pending, confirmed, shipped, delivered, cancelled), shipping address, and optional notes. Order items reference products with quantity and unit price. I need to search orders by customer name and filter by status and date range. The order form should calculate line totals automatically as items are added. Only admins can delete orders, and orders can only be cancelled if not yet shipped.代理随后会产出一份可直接进入实现的详细规格文档。官方还提供了一个对比案例用 Claude Opus 4.5Claude Code CLI、规划模式为SaaS 发票系统管理客户与产品、创建/编辑发票、添加明细、发送发票、记录跟踪付款生成实施计划要求端到端描述主要用户流程、把领域概念映射到具体 Filament 原语Resources、Relation Managers、Pages、Actions、识别状态流转如 draft → sent → paid及触发它们的 Actions。官方文档站点同时发布了不带 Blueprint与带 Blueprint的两份计划文本供对比细节与思考深度——你也可以把这两份计划交给自己的实现代理跑一遍亲身感受差异。需要注意的是该案例中planning-filament技能是在提示词开头被显式点名调用的。运行安全审计filament-security-audit 技能Blueprint 同时附带一个Filament Security Audit技能它对照一份已知安全误配置目录扫描 Filament 代码库涵盖授权、文件上传、XSS、查询范围限定、依赖 CVE 等并为每条发现编写整改计划。每条记录都会写明精确的文件、组件命名空间、文档 URL 和可直接粘贴的修复代码实现代理无需猜测即可应用修复。在提示词中显式点名技能是最可靠的调用方式当security-audit、security-review、harden、pen-test这些关键词与一个目标面板、资源、页面或 Livewire 组件搭配出现时该技能同样会被触发Using the filament-security-audit skill, audit the admin panel and write the remediation plan to SECURITY_AUDIT.md.代理会输出一份按发现类别分组的 Markdown 报告外加一张列出所有执行过的检查Finding/Pass/N/A的表格以及针对每个已确认问题的建议测试。反馈渠道与推荐工作流若在 Blueprint 上遇到问题或有改进建议可在 Blueprint 的 GitHub 专属 issue 仓库filamentphp/blueprint-issues提交 issue 或讨论账号或购买相关的问题可邮件联系 supportfilamentphp.com。综合上述文档内容与仓库源码证据AI 辅助开发 Filament 的推荐工作流可以归纳为装好基础层composer require laravel/boost --devphp artisan boost:install选择 Agent Skills并在代理 skills 目录确认filament-development/SKILL.md存在让代理自取文档需求不熟悉时依赖 Skill 内置的search-docs工作流查询官方文档而不是让模型凭记忆猜 API复杂功能先规划开启规划模式显式点名planning-filament技能产出 Blueprint再交给实现代理逐条落实——规划与实现分离是控制上下文消耗与代码质量的关键上线前安全体检对面板运行filament-security-audit按报告逐项修复并补齐建议测试升级注意从旧版 Boost 升级时重新运行boost:install并选择 Agent Skills 才能启用新技能boost:update不会替你完成这一步。这套技能文件 规划规格 安全审计的组合本质上是把 Filament 的框架约定转化为 AI 代理可消费的结构化知识让代理从会写 PHP升级为会写地道的 Filament。【免费下载链接】filamentA powerful open-source UI framework for Laravel • Build and ship apps admin panels fast with Livewire项目地址: https://gitcode.com/GitHub_Trending/fi/filament创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Filament AI 辅助开发指南：用 Laravel Boost Agent Skills 与 Blueprint 规划流编写地道框架代码
Filament AI 辅助开发指南用 Laravel Boost Agent Skills 与 Blueprint 规划流编写地道框架代码【免费下载链接】filamentA powerful open-source UI framework for Laravel • Build and ship apps admin panels fast with Livewire项目地址: https://gitcode.com/GitHub_Trending/fi/filament本文基于 Filament 官方文档的 AI 辅助开发章节展开讲解在 Filament 项目中引入 AI 编码代理的完整工作流安装 Laravel Boost 并启用 Filament 官方提供的 Agent Skill、用付费扩展 Filament Blueprint 为复杂功能生成精确的实施方案Blueprint、以及调用内置安全审计技能对面板做安全体检。读完后你应能配置好让 AI 代理写出符合框架约定代码的开发环境掌握规划代理 实现代理的分阶段开发模式并验证每一步安装产物。背景为什么 AI 代理需要Filament 专项训练Claude Code、Cursor、GitHub Copilot 等 AI 编码代理可以显著加速 Filament 开发但通用模型对框架的约定组件命名空间、布局默认值、测试写法并不天然了解容易生成看起来像、跑起来错的代码。Filament 的解法是向 Laravel Boost 提供一个Agent Skill它教会 AI 代理如何编写地道的 Filament 代码并遵循框架约定Laravel Boost 甚至允许代理在遇到不熟悉的需求时检索 Filament 官方文档获取答案。本页内容参考了 Laravel 官方的 AI 辅助开发文档。Laravel Boost 由 Laravel 团队开发其可用工具、文档检索与 IDE 集成等细节可查阅 Laravel 官方 AI 文档。安装 Laravel Boost 并启用 Filament Agent Skill将 Boost 作为开发依赖安装composer require laravel/boost --dev然后运行交互式安装器依次选择Agent Skills再选择filament/filament (skills)php artisan boost:install安装器会自动检测你使用的 IDE 和 AI 代理并生成相应的配置文件。验证方式检查你的代理的 skills 目录中是否存在filament-development/SKILL.md。注意如果你是在 Filament 提供 Agent Skill 之前安装的 Boost需要重新运行php artisan boost:install并选择Agent Skills才能启用单独运行php artisan boost:update并不会开启新功能。源码级实证仓库中自带的 filament-development Skill在当前 Filament 仓库中这个 Agent Skill 的真实内容就存放在 filament-development/SKILL.md随 panels 包一同分发。文档中提到的在代理 skills 目录检查filament-development/SKILL.md对应的正是安装器把这个技能文件写入你本地代理的 skills 目录。该 Skill 的 frontmatter 定义如下SKILL.mdname: filament-development description: Builds Filament application and admin panel interfaces. Use when creating, modifying, testing, or debugging Filament panels, resources, relation managers, pages, schemas, forms, tables, actions, infolists, widgets, imports, or exports.也就是说代理在创建、修改、测试、调试面板、资源、关系管理器、页面、Schema、表单、表格、操作、信息列表、部件、导入导出等场景下会触发该技能。从源码内容看Skill 教会代理的要点可以分为五类1. 使用官方文档检索。Skill 指示代理优先使用search-docs工具查询 Artisan 命令、代码示例、测试、关系与惯用写法——这印证了文档中Boost 允许代理检索 Filament 文档的说法同时要求始终使用 Filament 专属的 Artisan 命令创建文件并在运行前先检查可用选项、始终传递--no-interaction。2. 核心编码模式。Skill 给出了一批从源码结构看确实如此的可运行范式且与仓库实现一一对应用Get $get/Set $set实现字段间条件联动。这两个工具类确实存在于 packages/schemas/src/Components/Utilities/Get.php 与 Set.phpuse Filament\Forms\Components\Select; use Filament\Forms\Components\TextInput; use Filament\Schemas\Components\Utilities\Get; Select::make(type) -options(CompanyType::class) -required() -live(), TextInput::make(company_name) -required() -visible(fn (Get $get): bool $get(type) business),在-live()字段的-afterStateUpdated()中用Set做响应式更新文本输入优先-live(onBlur: true)以避免逐键触发布局用SectionGrid嵌套子组件默认占一列跨列用-columnSpan()/-columnSpanFull()Repeater::make(...)-relationship()无参绑定与字段同名的HasMany关系表格计算列用TextColumn::make(full_name)-state(fn (User $record) ...)筛选用SelectFilter枚举/关系与Filter::make()-query()自定义查询操作Action是按钮 可选模态表单 行为的封装。3. 命名空间精确清单。Skill 明确列出了各组件的正确命名空间表单字段在Filament\Forms\Components\、信息列表条目在Filament\Infolists\Components\、布局组件在Filament\Schemas\Components\、工具类在Filament\Schemas\Components\Utilities\、表格列在Filament\Tables\Columns\、筛选器在Filament\Tables\Filters\、操作统一在Filament\Actions\特别强调不要用Filament\Tables\Actions\或Filament\Forms\Actions\、图标用Filament\Support\Icons\Heroicon枚举。这正是文档所说覆盖代理常写错的细节命名空间、方法名、组件选择的落点。4. 常见错误清单。包括文件可见性默认private需要公开访问必须显式-visibility(public)Grid/Section/Fieldset/Repeater默认不占满整行不存在BelongsToSelectBelongsTo字段应使用Select::make(author_id)-relationship(author, name)Repeater用-schema()而非-fields()不要在需要保存的字段上加-dehydrated(false)覆写Page/Resource/Widget属性时保留联合类型如$navigationIcon是string | BackedEnum | null而非?string。5. 测试规范。Skill 给出基于 Pest Livewire 的完整测试范式测试面板功能前必须$this-actingAs(User::factory()-create())编辑页传[record $user-id]且调用-call(save)而非create表格测试用assertCanSeeTableRecords()/searchTable()验证失败断言用assertHasFormErrors()触发操作用-callAction(TestAction::make(name)-table($record))。另外值得一提本仓库根目录还有一份 AGENTS.md它面向直接在该框架仓库内工作的编码代理规定了变量命名、Pest 测试命名、流式 API、容器解析与可扩展性等约定。从文件职责划分看AGENTS.md服务的是框架自身的开发协作而filament-developmentSkill 服务的是终端用户应用——两者共同体现了把约定写成机器可读文件这一 AI 辅助开发实践。Filament Blueprint把规划与实现分离Filament 官方 Skill 主要面向实现型代理当代理已经知道要做什么时帮它写出正确的 Filament 代码。但 AI 生成代码的质量高度依赖计划的质量——实现代理拿到清晰、详尽的规格说明后可以把全部精力放在写对代码上而不是猜测需求或臆测意图。对复杂功能而言代理在规划阶段往往力不从心选错组件、关系结构设计不佳、想不全边界情况。模糊的计划导致模糊的代码最终你会花比节省下来更多的时间去纠正代理。Filament Blueprint 是一款付费premium扩展帮助 AI 代理为 Filament 生成准确、详尽的实施方案兼容 Filament v4 及以上版本。它的作用是填补你想要的与代理实际构建的之间的差距与其指望代理理解 Filament 约定不如用一个结构化的规划技能产出无歧义的规格文档。一份 Blueprint 会写明实现代理需要的一切模型Models属性、casts、关系、带精确语法的枚举资源Resources完整命名空间、脚手架命令、配置表单Forms字段组件、验证规则、布局结构表格Tables列、筛选器、操作、排序行为授权Authorization可直接翻译为代码的英文策略规则测试Testing测试什么、如何验证可用更多响应式字段、向导wizards、导入/导出、批量操作、部件、多租户等规划技能覆盖了代理常写错的细节命名空间、方法名、组件选择、嵌套布局计算让实现代理可以一次写对。同时该规划技能只面向规划代理不会占用实现代理的上下文窗口规划代理会把所有必要细节命名空间、需要抓取的文档 URL、精确方法语法直接复制进 Blueprint 本身实现代理无需再加载规划技能即可拿到全部信息。安装 BlueprintBlueprint 兼容 Filament v4 及以上版本。先为 Blueprint 购买许可证通过 Filament Packages 门户然后用 Composer 安装composer config repositories.filament composer https://packages.filamentphp.com/composer composer config --auth http-basic.packages.filamentphp.com YOUR_EMAIL_ADDRESS YOUR_LICENSE_KEY composer require filament/blueprint --dev接着运行 Boost 安装器选择Agent Skills再选择filament/blueprint (skills)php artisan boost:install验证方式在代理的 skills 目录中检查是否存在planning-filament/SKILL.md和filament-security-audit/SKILL.md。要访问已购买的许可证请使用购买 Blueprint 时的邮箱登录 Filament Packages 门户。使用 Blueprint规划模式生成实施方案要创建 Blueprint在你的 AI 代理中开启规划模式planning mode并要求它使用planning-filament技能。官方文档给出的示例提示词Using the planning-filament skill, create a Filament Blueprint for an order management system. Orders belong to customers and have many order items. Each order has a status (pending, confirmed, shipped, delivered, cancelled), shipping address, and optional notes. Order items reference products with quantity and unit price. I need to search orders by customer name and filter by status and date range. The order form should calculate line totals automatically as items are added. Only admins can delete orders, and orders can only be cancelled if not yet shipped.代理随后会产出一份可直接进入实现的详细规格文档。官方还提供了一个对比案例用 Claude Opus 4.5Claude Code CLI、规划模式为SaaS 发票系统管理客户与产品、创建/编辑发票、添加明细、发送发票、记录跟踪付款生成实施计划要求端到端描述主要用户流程、把领域概念映射到具体 Filament 原语Resources、Relation Managers、Pages、Actions、识别状态流转如 draft → sent → paid及触发它们的 Actions。官方文档站点同时发布了不带 Blueprint与带 Blueprint的两份计划文本供对比细节与思考深度——你也可以把这两份计划交给自己的实现代理跑一遍亲身感受差异。需要注意的是该案例中planning-filament技能是在提示词开头被显式点名调用的。运行安全审计filament-security-audit 技能Blueprint 同时附带一个Filament Security Audit技能它对照一份已知安全误配置目录扫描 Filament 代码库涵盖授权、文件上传、XSS、查询范围限定、依赖 CVE 等并为每条发现编写整改计划。每条记录都会写明精确的文件、组件命名空间、文档 URL 和可直接粘贴的修复代码实现代理无需猜测即可应用修复。在提示词中显式点名技能是最可靠的调用方式当security-audit、security-review、harden、pen-test这些关键词与一个目标面板、资源、页面或 Livewire 组件搭配出现时该技能同样会被触发Using the filament-security-audit skill, audit the admin panel and write the remediation plan to SECURITY_AUDIT.md.代理会输出一份按发现类别分组的 Markdown 报告外加一张列出所有执行过的检查Finding/Pass/N/A的表格以及针对每个已确认问题的建议测试。反馈渠道与推荐工作流若在 Blueprint 上遇到问题或有改进建议可在 Blueprint 的 GitHub 专属 issue 仓库filamentphp/blueprint-issues提交 issue 或讨论账号或购买相关的问题可邮件联系 supportfilamentphp.com。综合上述文档内容与仓库源码证据AI 辅助开发 Filament 的推荐工作流可以归纳为装好基础层composer require laravel/boost --devphp artisan boost:install选择 Agent Skills并在代理 skills 目录确认filament-development/SKILL.md存在让代理自取文档需求不熟悉时依赖 Skill 内置的search-docs工作流查询官方文档而不是让模型凭记忆猜 API复杂功能先规划开启规划模式显式点名planning-filament技能产出 Blueprint再交给实现代理逐条落实——规划与实现分离是控制上下文消耗与代码质量的关键上线前安全体检对面板运行filament-security-audit按报告逐项修复并补齐建议测试升级注意从旧版 Boost 升级时重新运行boost:install并选择 Agent Skills 才能启用新技能boost:update不会替你完成这一步。这套技能文件 规划规格 安全审计的组合本质上是把 Filament 的框架约定转化为 AI 代理可消费的结构化知识让代理从会写 PHP升级为会写地道的 Filament。【免费下载链接】filamentA powerful open-source UI framework for Laravel • Build and ship apps admin panels fast with Livewire项目地址: https://gitcode.com/GitHub_Trending/fi/filament创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考