Agent Skills
返回列表
💻

WordPress Gutenberg 区块脚手架

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/wordpress-gutenberg-block-scaffolder。

技能介绍

要解决的具体问题

在 WordPress Gutenberg 中开发自定义区块时,手动维护 block.json 元数据、InspectorControls 和 register_block_type 回调不仅繁琐,还容易因字段遗漏或版本差异导致区块无法正确注册。开发者需要反复对照 Block API v2 的规范,重复编写脚手架代码,调试成本高。

技能如何工作

该技能基于 @wordpress/create-block 和 Block API v2 生成标准化的自定义区块结构,核心能力包括:

  • 生成脚手架:按官方流程快速搭建区块所需的目录与文件,减少手动初始化的重复劳动。
  • 配置元数据:自动写入 block.json 中的关键字段,保证区块注册信息与 Block API v2 一致。
  • 扩展编辑界面:通过 InspectorControls 注入区块设置面板,支持在编辑器侧栏定义自定义字段。
  • 注册服务端渲染回调:利用 register_block_type 配置服务端渲染逻辑,确保前端输出符合预期。

适用边界与注意点

  • 未自动提取到受源支持的安装或使用说明,在敏感流程中运行前需先审核上游项目。
  • 生成的代码遵循 Block API v2,如项目依赖旧版区块 API 或自定义加载流程,需手动调整。
  • 适合需要快速搭建基础区块结构的开发场景,复杂交互或深度定制仍需结合业务自行扩展。

使用场景

  • 在 WordPress 插件中从零创建自定义区块,需要生成目录结构与 `block.json` 元数据文件
  • 为 Gutenberg 区块添加编辑器侧边栏设置项,需要用 `InspectorControls` 注册自定义控件
  • 区块需要在前端输出自定义 HTML,要用 `register_block_type` 编写服务端渲染回调
  • 将既有区块迁移到 Block API v2 规范,需要按新格式重写区块注册与元数据配置

适合人员

  • 开发 WordPress 插件的工程师,需要快速生成符合 Block API v2 规范的自定义区块骨架
  • 维护 Gutenberg 扩展功能的前端工程师,需要为区块配置 `InspectorControls` 设置面板
  • 为内容团队定制编辑器体验的 WordPress 开发者,需要实现区块的服务端渲染输出