用途
wordpress-theme-to-emdash 是一个用于把 WordPress 主题的设计与模板行为迁移到由 EmDash 驱动的 Astro 站点的技能。它适用于主题迁移、设计匹配、PHP 模板转换，以及需要在 EmDash 上重建 WordPress 主题布局与交互的场景。
主要能力
该技能覆盖从证据采集到最终验证的迁移流程，包括：将 PHP 模板转换为 Astro 路由、布局和组件；将自定义文章类型、元数据和分类法转换为 EmDash 集合、字段和分类法；将主题自定义器值转换为站点设置或项目配置；将菜单位置转换为具名 EmDash 菜单；将侧边栏和挂件转换为挂件区域或普通 Astro 组件。它还提示短代码和插件自有行为可能需要单独的插件迁移。
使用方式
- 加载 building-emdash-site，获取当前 EmDash 的 schema、查询、渲染、缓存和种子数据模式。
- 若存在线上参考站点，使用 agent-browser CLI 进行渲染对比；运行 agent-browser skills get core --full 查看其命令参考。
- 按优先级选择证据：主题源码与 theme.json、样式表、模板、functions.php；具有代表性的桌面和移动视口线上演示；用户提供的截图或设计文件；在来源含糊时采用明确的设计决策。
- 规划迁移范围：仅清点所需页面类型、组件、响应式状态和交互，然后按 WordPress 职责到 EmDash 的映射关系实施。
- 阅读 WordPress 主题概念映射说明，以翻译模板层级、functions.php 注册、模板标签、钩子、挂件或可复用块。
- 动态 EmDash 内容路由必须保持服务端渲染；EmDash 媒体字段使用 EmDash Image 组件，普通主题资源可使用 Astro 的资源处理。
- 分阶段推进，仅在阶段适用时读取对应阶段文件：发现与参考捕获、设计提取、模板转换、动态 EmDash 功能、schema 与种子数据、渲染验证。
- 创建独立主题项目时，从仓库当前站点模板或用户现有项目开始；写入前确认目标位置，未经明确指示不得替换现有站点结构。
- 构建站点并逐项验证范围内页面与交互，在匹配视口下与参考对比，包括响应式导航、长内容和缺失值、当管理端或主题行为依赖方向时的 RTL、以及相关的空状态或错误状态。
- 若视觉还原度属于验收条件，采集迁移前后或参考与结果的截图。报告有意的偏差、缺失的源证据、不支持的 WordPress 行为以及资源替换情况。
适用场景
- WordPress 主题迁移到 EmDash + Astro 站点。
- 需要匹配原主题设计并转换 PHP 模板。
- 将 WordPress 的 CPT、元数据、分类法、菜单、挂件等结构映射到 EmDash 对应结构。
- 需要基于线上演示或截图进行渲染对比验证的迁移项目。
限制与注意事项
- 不要假设每个 WordPress 模板或演示功能都属于迁移范围；应保留用户要求的视觉保真度和功能范围。
- 不要推断演示内容或图片与主题代码采用相同许可证；仅在许可证或用户权利允许时复用资源，否则应使用具有明确许可证、尺寸与视觉分量相近的替代品。
- 不得仅因源是 WordPress 主题就将迁移结果标记为 GPL-2.0-or-later；应检查源主题的实际许可证与声明，保留必需的版权与署名，为复用代码附上适用许可证文本，并单独标识第三方资源。
- 动态 EmDash 内容路由必须保持服务端渲染。
- 短代码和插件自有行为可能需要单独的插件迁移。
- 本技能资料未提供具体收费、价格、平台或效果信息，相关事实暂未提供。