wp-patterns 是 WordPress Agent Skills 仓库中的一个技能,专注创建或更新 WordPress 区块模式(Block Patterns),覆盖区块、起始页面、模板、模板部件及 Query Loop 布局,并审查模式注册、区块标记与设计质量。
用途:为区块主题或插件生成合规的模式文件,并在真实 WordPress 环境中验证。
主要能力:按五步流程工作——定位目标主题/插件、做五项设计决策(目的、语气、空间构图、字体层级、配色策略)、规划区块嵌套树、编写 PHP 头部与区块标记、通过设计与技术检查清单并验证。要求仅用区块标记表达设计,使用预设 slug 控制颜色、字号与间距,禁止内联 <style>、自定义 CSS 类或额外 HTML,禁止 JavaScript,用占位文本反映真实内容。行为类需求使用原生区块(Query Loop、Search、Navigation 等),本地资源用 get_theme_file_uri() 配合 esc_url()。
使用方式:仓库内可先运行 node skills/wp-project-triage/scripts/detect_wp_project.mjs 做项目分流;区块主题可运行 node skills/wp-block-themes/scripts/detect_block_themes.mjs 定位主题根目录。用 npx @wp-playground/cli@latest server --auto-mount 在 WordPress Playground 中验证,或把区块标记粘贴到代码编辑器手动检查。模式文件放在 patterns/*.php,或按插件方式手动注册;注册 PHP 仅在注册时执行一次。
适用场景:创建起始页面、模板/模板部件模式、Query Loop 布局、表单/CTA、对比/定价、社交/导航/搜索、404 等模式;更新已有模式并保持兼容。
限制:更新模式文件不会追溯更新已插入文章/模板中的内容;改动区块名或保存标记可能触发恢复提示;需确认主题预设 slug、text domain、资源路径;缺少 theme.json 或预设不可验证时应保守使用核心预设或先询问;仓库兼容契约之外的 WordPress/Gutenberg 版本行为暂未提供。