mcpField
S
shopware-admin-crud-module

shopware-admin-crud-module

github.com/friendsofshopware开发1353 次安装34 周前更新
代码仓库

关于 shopware-admin-crud-module

用于为 Shopware DAL 实体构建 Administration CRUD 模块的技能。它依据项目参考规范，指导模块设置、列表和详情页、ACL、搜索、筛选及本地化文件生成。

主要功能

  1. 01模块注册与文件结构
  2. 02列表页和详情页模式
  3. 03ACL 权限映射
  4. 04搜索与筛选设置
  5. 05本地化片段搭建

适用场景

  1. 01为 DAL 实体创建管理模块
  2. 02添加实体列表页和详情页
  3. 03配置模块 ACL 权限
  4. 04搭建管理界面翻译文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/friendsofshopware/agent-skills --skill shopware-admin-crud-module

安装后在 Claude Code 中输入/shopware-admin-crud-module确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
_sections.md
_template.md
acl-privileges.md
module-registration.md
module-search-configuration.md
page-detail.md
page-list.md
snippet-structure.md

详细介绍

Shopware 管理后台 CRUD 模块

适用场景

  • 为 Shopware DAL 实体创建新的管理后台模块
  • 在管理后台为实体添加列表、详情和创建页面
  • 为管理后台模块配置 ACL 权限
  • 为实体列表添加搜索、筛选器和内联编辑
  • 为新模块搭建管理后台 i18n 片段

按优先级划分的规则类别

优先级类别前缀描述
CRITICAL模块设置module-模块注册、文件结构、命名约定
CRITICAL页面page-列表页和详情／创建页模式
HIGHACL 与搜索acl-ACL 权限映射和搜索配置
MEDIUM片段与筛选器snippet-i18n 片段结构和筛选器设置

使用方法

用户调用此技能时，请询问他们：

  1. 实体名称（DAL 实体，例如 webhook）——如果未作为参数提供
  2. 要在列表和详情中显示的字段（或者自动从 EntityDefinition PHP 类读取）
  3. 要使用的模块前缀（默认值：frosh-tools-<entity>）

然后从 references/ 目录读取相关参考文件，并按照其中描述的模式生成所有文件。管理后台源码根目录为 src/Resources/app/administration/src/。

命名约定
  • 模块名称：frosh-tools-<entity>（连字符分隔）
  • 路由前缀：frosh.tools.<entity>（点号分隔）——由模块名称中的连字符替换为点号得出
  • ACL 键：frosh_tools_<entity>（下划线分隔）
文件结构
module/<module-name>/
  index.js                          # Module registration + search type + lazy component loading
  default-search-configuration.js   # Search ranking config
  acl/
    index.js                        # ACL privilege mapping
  snippet/
    en-GB.json
    de-DE.json
  page/
    <module-name>-list/
      index.js
      template.html.twig
    <module-name>-detail/
      index.js
      template.html.twig

还需在 main.js 中添加 import './module/<module-name>';。

外部参考

评论

支持 Markdown