用途:当用户需要新的 WordPress 主题,或要对本地 Studio 站点做较大视觉改版时使用此技能。它负责区块主题实现规则、落地页与模板组合、WordPress 原生布局结构,以及主题文件在所选 Studio 站点内的放置。主题完成后可用 studio 进行审阅迭代;若还需性能、可访问性或前端整体 QA,则使用 auditing。
主要能力:构建区块主题而非经典主题,使用 theme.json、template parts、templates、核心区块等现代模式;优先用 CSS 与区块组合,而非原始 HTML 区块;保持主题在站点编辑器中可编辑;用 Studio 工具完成激活、验证和截图。
必需文件至少包括:theme.json、style.css、functions.php、templates/index.html、templates/page.html、parts/header.html、parts/footer.html。
使用方式:先确定清晰的视觉方向,构建有吸引力的落地页,运用有目的的字体、间距与颜色,适配桌面与移动端;若调用方提供设计预览,则以该预览作为页眉、首屏和整体设计语言的主要来源。在主文件写入阶段之前,调用 record_workflow_event,参数 workflow 为 "theme-build",stage 为 "started"。
主题规则:布局分区和常规文本内容不使用 core/html 区块;只使用正确的区块标记;区块分隔符外不加装饰性 HTML 注释;视觉样式放在 style.css;区块主题不会自动在前台加载 style.css,必须在 functions.php 中通过 wp_enqueue_scripts 钩子调用 wp_enqueue_style( '<slug>-style', get_stylesheet_uri() ) 显式入队;入队编辑器样式使编辑器接近前台效果;使用动画时加入 prefers-reduced-motion 处理。
布局规则:选择最适合需求的布局方式,不要强行让每个站点都采用全宽落地页带。若采用全宽分区,优先使用 WordPress 原生全宽结构:外层顶层 core/group 使用 {"align":"full","layout":{"type":"default"}};全宽落地页分区采用严格外壳模式,外层为 align:"full" 且 layout.type:"default" 的 core/group,内层内容外壳为其直接子级 align:"wide" 的 core/group,需要开阔感时其内主 core/columns 也用 align:"wide";可读文本和卡片网格放在内层容器块中,而非约束外层全宽分区。theme.json 布局设置应与设计一致,包含合理的 contentSize 与 wideSize;不要仅靠 CSS 让受限块看起来全宽;若使用全宽块后截图仍显示盒状或受限分区,应先检查包装器对齐、序列化区块标记、模板布局和 theme.json,再添加自定义突破 CSS。
验证流程:写入或更新区块主题文件后,对每个含序列化区块标记的模板或模板部件文件运行 studio 区块验证循环;若报告无效区块,修复标记并重复运行直至全部通过;用 wp_cli 激活主题;必要时用 wp_cli 更新站点设置;按 studio 中的审阅与迭代流程操作;最后调用 record_workflow_event,参数 workflow 为 "theme-build",stage 为 "completed"。
限制:本资料未提供价格、平台支持范围、性能或效果保证等具体信息。