SuperAPI AI 工具集

editing-themes

前端与建站

查看项目

更新于 10-15 19:58

技能介绍

用途:当工作区中已存在主题、需要修改现有 WordPress 区块主题时使用此技能;资料说明不适用于从零创建新主题。

主要能力与规则:绝不重新创建或覆盖用户未要求更改的文件,例如用户要求“添加新闻简报模板”时,只新增相应模板或图案文件并更新索引模板;除用户请求明确需要(如新增颜色、更改字体、注册新资源)外,不重写 theme.json、functions.php 或 style.css;不改变主题的主题方向、品牌或内容方向,例如舞蹈工作室主题的新增内容需与舞蹈工作室情境相符,而非通用占位内容;不删除现有图案、模板或模板部件,除非用户明确要求。

编辑指引:改动前先阅读 theme.json、style.css 和 functions.php,了解现有配置、设计令牌与已注册资源;做最小化、有针对性的更改,只修改用户要求的内容;只触碰需要变更的文件,不重写无关模板或图案;定向修改使用 edit 工具,仅当替换文件超过 50% 时才用 write;修改颜色、排版或间距时更新 theme.json 而非 CSS,除非该更改无法在 theme.json 中表达;新增或修改模板部件时,如有需要,确保在 theme.json 中注册;除非用户明确要求,保留主题现有设计方向与美学;新增内容(图案、模板)需匹配主题既有主题、语气与视觉风格;更改后验证模板仍引用有效的模板部件与图案。

参考文件:编辑主题文件前,先阅读 creating-themes/references/ 目录下的相关参考。block-html.md 为必读且需最先阅读,包含区块 HTML 有效性规则、区块注释与 HTML 的匹配、图片/封面/按钮区块结构,违反会导致“unexpected or invalid content”错误;design-direction.md 为必读,在生成任何主题文件前阅读;navigation.md 在生成页眉模板部件前阅读,涵盖 wp:navigation 区块标记与覆盖层(汉堡菜单);query-loop.md 在主题需在模板或图案中显示动态内容(博客文章、归档、搜索结果)时阅读。

限制:资料未提供具体安装命令、收费或平台信息;仅涉及编辑主题的工作流与约束,未说明与其他工具的集成方式。