关于 wordpress-theme-to-emdash
这是一项将 WordPress 主题重建为由 EmDash 支持的 Astro 站点的技能。它帮助开发者确定页面范围、映射主题功能，并验证渲染效果与素材许可。
主要功能
- 01将主题组件映射到 Astro
- 02规划 EmDash 集合与设置
- 03分阶段指导实现工作
- 04验证响应式页面渲染
- 05处理素材许可与署名
适用场景
- 01在 EmDash 中重建 WordPress 主题
- 02将主题模板映射为 Astro 路由
- 03对照线上参考检查页面效果
- 04迁移主题时核实素材权利
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/wordpress-theme-to-emdash确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
phases/1-discovery.md2-design.md3-templates.md4-dynamic.md5-seed.md6-verify.mdreferences/concept-mapping.md详细介绍
将 WordPress 主题移植到 EmDash
将主题中相关的布局和交互重建为由 EmDash 支持的 Astro 站点。保留用户要求的视觉还原度和功能范围；不要假设所有 WordPress 模板或演示功能都应包含在移植版本中。
加载 building-emdash-site，了解当前的 EmDash 架构、查询、渲染、缓存和种子数据模式。如果有可用的在线参考站点，请使用 agent-browser CLI 进行渲染效果对比；运行 agent-browser skills get core --full 查看其命令参考。
选择依据
按以下顺序使用最佳可用来源：
- 主题源代码、
theme.json、样式表、模板和functions.php； - 在具有代表性的桌面和移动视口下运行的在线演示；
- 用户提供的截图或设计文件；
- 在来源含糊不清时明确做出的设计决策。
不要推断演示内容或图片与主题代码享有相同的许可。只有在许可或用户权利允许时，才能复用资源；否则，请使用尺寸和视觉分量相近且许可明确的替代资源。
规划移植工作
只盘点所需站点涉及的页面类型、组件、响应式状态和交互。实施前，先映射 WordPress 各项职责：
- PHP 模板转换为 Astro 路由、布局和组件。
- 自定义文章类型、元数据和分类法转换为 EmDash 集合、字段和分类法。
- 主题自定义器的值转换为站点设置或明确的项目配置。
- 菜单位置转换为由模板查询的命名 EmDash 菜单。
- 侧边栏和小工具转换为小工具区域或普通 Astro 组件。
- 短代码和由插件实现的行为可能需要单独进行插件迁移。
在转换模板层级、functions.php 注册项、模板标签、钩子、小工具或可复用区块时，请阅读 WordPress 主题概念映射。
动态 EmDash 内容路由必须保持服务端渲染。对于 EmDash 媒体字段，请使用 EmDash Image 组件；普通主题资源可以使用 Astro 的资源处理方式。
分阶段开展工作
仅在适用时阅读相应阶段的文件：
创建独立主题项目时，请从仓库当前的站点模板或用户现有项目开始。写入之前先确认目标位置；未经明确指示，不要替换现有站点结构。
验证结果
构建站点，并测试所有涉及的页面和交互。将匹配视口与参考进行对比，包括响应式导航、含有较长值和缺失值的内容、管理界面或主题行为涉及方向时的 RTL，以及相关的空状态或错误状态。
如果视觉还原度属于验收标准，请截取前后对比图或参考与结果的对比图。说明有意做出的偏差、缺失的源资料、未支持的 WordPress 行为，以及替换的资源。
许可与署名
检查源主题实际采用的许可和声明。保留所需的版权和署名信息；复用代码时，附上适用的许可文本，并单独注明第三方资源。不要仅仅因为源代码是 WordPress 主题，就将移植版本标记为 GPL-2.0-or-later。