wp-block-development

用途：面向 WordPress（Gutenberg）区块的开发与维护，适用于新建或更新区块、修改 block.json（脚本/样式/supports/属性/render/viewScriptModule）、排查“区块无效/不保存/属性未持久化”、添加动态渲染、处理弃用与迁移，以及区块构建工具相关任务。使用前需要仓库根目录与目标（插件、主题或整站）、区块名称与命名空间及其位置、目标 WordPress 版本范围。流程：先运行 node skills/wp-project-triage/scripts/detect_wp_project.mjs 与 node skills/wp-block-development/scripts/list_blocks.mjs 定位区块根目录；新建区块优先用 @wordpress/create-block 脚手架，需要 Interactivity API 用 interactive 模板；确保 apiVersion 3（WordPress 6.9+ 强制），注意 iframe 编辑器下的样式与脚本作用域；选择静态或动态区块模型，动态渲染使用 block.json 的 render 或 PHP 的 render_callback，现代视图脚本优先 viewScriptModule；注册优先使用 PHP 元数据注册；包装属性分别使用 useBlockProps()、useBlockProps.save()、get_block_wrapper_attributes()；嵌套区块使用 useInnerBlocksProps()；修改已保存标记或属性时添加 deprecated 条目并可选 migrate，避免“Invalid block”。验证：区块可插入、保存重载不报无效、前后端输出与资源加载符合预期，并运行仓库的 lint/build/test。限制：资料未提供具体版本兼容矩阵、示例代码与排错细节之外的额外支持范围，遇到上游行为或版本支持不确定时应查阅官方文档。