Fastadmin创建插件:用 Agent Skill 搭 FastAdmin 插件骨架

前言

在 FastAdmin 里做应用插件,往往要反复对齐目录约定:控制器、模型、视图、配置、菜单和数据库脚本各放在哪、命名怎么跟框架一致。手工从空白目录搭一遍,容易漏文件或结构不符合官方插件规范,后面改菜单、打包上架又要回头补。

下面介绍 SkillHub 上的社区 Skill「Fastadmin创建插件」(坐标 @user_673f0e46/fastadmin-addon)。它面向「创建、开发、打包 FastAdmin 应用插件」这类对话场景,由 Agent 按 Skill 指引生成插件目录结构与常见代码/配置产物,减少从零对照文档抄结构的时间。

这是什么

「Fastadmin创建插件」是 FastAdmin 插件开发助手 Skill,版本 1.0.0,来源为 community,分类 dev-programming,发布者为 user_673f0e46。页面标注 requires_api_key=false,安装本 Skill 本身不需要额外 API Key。

官方说明中的定位:在用户需要创建 FastAdmin 插件、开发插件功能、配置插件菜单与数据库、打包插件时使用;支持生成插件目录结构、控制器、模型、视图、配置文件、菜单配置、数据库脚本等。

  • SkillHub 展示页:https://www.skillhub.cn/skills/user_673f0e46/fastadmin-addon
  • API 坐标页:https://api.skillhub.cn/user_673f0e46/fastadmin-addon

核心功能

以下能力均来自官方简介,不展开未在资料中出现的具体命令或框架版本:

  1. 创建插件:生成符合 FastAdmin 插件习惯的目录结构。
  2. 开发功能:协助产出控制器、模型、视图等常见分层文件。
  3. 配置与数据:协助菜单配置、插件配置文件,以及数据库相关脚本。
  4. 打包:在对话中引导完成插件打包相关步骤(具体流程以 Skill 内指引与项目实际为准)。

安装与启用

SkillHub 推荐通过通用安装文档安装本 Skill。安装前需已具备 skillhub CLI;若尚未安装,可先按官方文档检查版本:

command -v skillhub && skillhub --version

未安装时,可使用文档中的完整安装脚本(需联网):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill 时,必须用 --dir 指向当前 Agent 的 skills 目录;默认装到 ./skills/ 可能不会被当前客户端识别。通用命令形式如下:

skillhub install @user_673f0e46/fastadmin-addon --dir <skills 目录>

也可将下面提示词发给支持 Skill 的 AI,让其按安装文档操作:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_673f0e46/fastadmin-addon`。

各客户端 skills 目录(摘自 SkillHub 安装文档,以你本机实际为准):

客户端 常见 skills 路径
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下的 .agents/skills/
Windsurf ~/.codeium/windsurf/skills/ 或 .windsurf/skills/

安装文档还提到:装到正确目录后,部分环境仍可能需要重启客户端才能加载新 Skill。Cursor、Codex CLI、Claude Code 在「安装命令」层面均走同一套 skillhub install;差异主要在 skills 目录路径 与是否需重启,文中未单独写明的客户端差异不再臆测。

更完整的优先源与搜索说明见:https://skillhub.cn/install/skillhub.md

典型用法

本 Skill 没有单独公开一段「复制即用」的示例仓库;典型用法即:在已安装 Skill 的 Agent 里,用自然语言说明你要做的插件阶段,并带上项目上下文(插件英文名、已有表结构、要挂的菜单等),让 Agent 按 Skill 生成或补全文件。

可复现的触发场景(与官方简介一致):

  1. 新建插件:说明插件标识与要实现的后台功能,请求生成目录结构及基础控制器/模型/视图。
  2. 菜单与权限:说明要在 FastAdmin 后台出现的菜单层级,请求生成或调整菜单配置。
  3. 数据库:说明表字段或变更意图,请求生成数据库脚本草案(上线前仍需你在目标环境校验 SQL 与迁移策略)。
  4. 打包:说明准备发布或交付,请求按 FastAdmin 插件打包习惯整理产物(以 Skill 内步骤与你本地 FastAdmin 版本为准)。

示例提示(示意结构,非官方固定模板):

我要在当前 FastAdmin 项目里新建一个应用插件,插件标识为 example。
请按 FastAdmin 插件规范生成目录结构,并给出后台列表页的控制器、模型、视图和菜单配置草案。

经过上面的步骤,你应拿到可放入项目、再人工审查与联调的一揽子草案,而不是替代完整的业务测试与上线流程。

适用场景与注意

适合谁

  • 使用 FastAdmin 做后台、需要频繁新增或维护应用插件的 PHP 开发者。
  • 希望由 Agent 统一生成插件骨架、减少对照文档手抄目录的人。

限制与注意

  • 来源为 community,生成代码与 SQL 需按你项目的 FastAdmin 版本、安全规范与编码规范做审查,不宜未经测试直接上生产。
  • Skill 页未承诺绑定特定 FastAdmin 或 PHP 版本号;与框架不一致时以你本地官方文档为准修改生成结果。
  • SkillHub 页面统计(截至资料抓取):评分 100000,下载 756,安装 4;热度不等于质量,仍建议小范围试用后再纳入团队规范。
  • 本 Skill 不要求 API Key;若插件业务本身调用第三方接口,密钥管理仍由项目自行配置,勿写入对话或仓库明文。

结尾

「Fastadmin创建插件」把 FastAdmin 插件从建目录、写分层、配菜单到数据库脚本与打包等重复性工作,收敛到一次对话驱动的 Skill 流程里,适合作为插件开发的起步脚手架。需要安装或查看说明时,以 SkillHub 展示页与 API 坐标页为准:

  • https://www.skillhub.cn/skills/user_673f0e46/fastadmin-addon
  • https://api.skillhub.cn/user_673f0e46/fastadmin-addon
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye