# 09 · 开工提示词模板

> 适用：把本技能包复制到新项目后，**由你（用户）复制下面这段提示词发给 AI**，一次性交代清项目信息，避免 AI 靠猜。
> 用法：把代码块里的 `{{...}}` 占位符逐项填好（括号里是示例）；没有要求的项直接删掉或写「不需要」，**不要留空占位符**。
> 发送时把提示词与这句话放在一起：**「请按 .trae/skills/wp-theme-authoring 的规范来做」**。
> 相关分册：能力模块选型 `04-能力模块清单.md`｜SEO 分工 `06-SEO与Yoast集成.md`｜执行与自检清单 `08-AI执行清单.md`。

---

## 一、开工提示词（整段复制，填好占位符后发出）

```
【角色与任务】
你是我的 WordPress 主题开发助手。请先完整学习本项目 .trae/skills/wp-theme-authoring 技能包
（SKILL.md + references/01~09 + templates/），再按其中的规范为我编写一个经典 PHP 主题
（非 FSE / 非区块主题），样式用 Tailwind CSS 4 + daisyUI 5 预编译。
动手前先按 references/08-AI执行清单.md 的「动手前」清单，就不确定的地方向我提问，不擅自扩大范围。

【一、项目与主题】
- 站点类型：{{站点类型，例：博客 / 音乐站 / 视频站 / 工具站}}
- 主题名：{{主题名，例：Acme Blog}}
- 主题 slug（同时作为目录名与 Text Domain）：{{主题 slug，例：acme-blog}}
- 品牌名：{{品牌名，例：Acme}}
- 品牌色：{{品牌色，例：用 daisyUI 主题色 primary=#4f46e5；或给出自定义色值}}
- 是否已有 logo：{{已有（文件在 {{logo 路径}}）/ 没有}}
- 是否已有 favicon：{{已有（文件在 {{favicon 路径}}）/ 没有}}

【二、目标环境】
- WordPress 版本：{{WP 版本，例：6.6}}
- PHP 版本：{{PHP 版本，例：8.2}}
- 是否在 CDN / 反向代理之后：{{是 / 否}}；若是，真实访客 IP 的来源请求头为
  {{HTTP_CF_CONNECTING_IP（Cloudflare）/ HTTP_X_FORWARDED_FOR（通用反代）/ 其它}}
- Web 服务器：{{nginx / Apache}}

【三、页面清单（需要哪些模板）】
- 首页 front-page.php：{{需要 / 不需要}}；类型为 {{工具型（进来即操作）/ 内容型（展示文章流）}}
- 文章列表 home.php：{{需要 / 不需要}}；后台是否已指定「文章页」：{{已指定（页面：{{页面名}}）/ 未指定}}
- 文章详情 single.php：{{需要 / 不需要}}
- 单页面 page.php：{{需要 / 不需要}}
- 归档 archive.php（分类 / 标签 / 日期 / 作者）：{{需要 / 不需要}}
- 搜索 search.php + searchform.php：{{需要 / 不需要}}
- 404.php：{{需要 / 不需要}}
- 其它模板：{{按需补充，例：自定义文章类型的归档模板}}

【四、内容结构】
- 是否需要自定义文章类型（CPT）：{{需要（类型：{{例：album 专辑 / track 曲目 / video 视频 / playlist 播放列表}}）/ 不需要}}
- 是否需要自定义分类（taxonomy）：{{需要（分类法：{{例：album-cat / video-cat}}，关联到哪些 CPT）/ 不需要}}
- 分类与标签的使用方式：{{例：分类做栏目、标签做细分词，每篇标签不超过 5 个}}

【五、能力模块（对照 references/04-能力模块清单.md 勾选，未勾选的一律不做）】
- [ ] 评论（含嵌套回复与引用通告）   - [ ] 分页（列表 + 评论）   - [ ] 面包屑
- [ ] 搜索                          - [ ] 相关文章侧栏          - [ ] 特色图片
- [ ] 图集与灯箱                    - [ ] 视频嵌入             - [ ] 音频播放器
- [ ] 目录 TOC                      - [ ] 评分 / 点赞          - [ ] 作者卡片
- [ ] 订阅 / RSS
补充说明：{{例：哪些是本项目必做，哪些可延后}}

【六、SEO】
- 使用的 SEO 插件：{{Yoast SEO / Rank Math / 无}}
- 站点主关键词方向（1~3 个）：{{例：虚拟邮箱、临时邮箱}}
- 是否需要输出 meta keywords：{{需要（走主题侧补齐）/ 不需要}}
- 约定：SEO 主引擎负责 title / description / canonical / robots / OG / JSON-LD / sitemap，
  主题不得重复输出这些标签；只按 references/06-SEO与Yoast集成.md 做主题侧补齐。

【七、样式与交互】
- 是否需要深色模式：{{需要（跟随系统 / 提供手动切换）/ 不需要}}
- 品牌色以外的设计要求：{{例：大圆角、留白多；参考站 {{参考站地址}}}}
- 是否需要前端 JS 交互：{{需要（交互项：{{例：点赞、灯箱、复制按钮}}）/ 不需要}}
  约定：JS 放 assets/js/ 下，用 wp_localize_script 只下发必要配置（如 restUrl），绝不把密钥下发前端。

【八、交付要求】
1. 先在主题目录执行 npm install + npm run build:css，确认生成 assets/css/tailwind.css；
   之后任何新增 / 修改的 Tailwind / daisyUI 类名，都要重新执行 npm run build:css。
2. 全程按 references/08-AI执行清单.md 执行「动手前 → 实现中 → 完成前」清单。
3. 交付前自检：全部 PHP 文件 php -l 无语法错误；浏览器几何验收两栏成立 / sticky 生效 /
   窄屏顺序为「正文 → 侧栏 → 评论」/ 三档视口（1440、1024、375）无横向溢出；每页有且仅有一个 h1。
4. 只改动本次任务清单内的文件，不改动与本任务无关的既有代码。

【九、部署方式】
- 交付形式：{{本地主题目录 / 生成可后台上传的 zip / 推送到 Git 仓库}}
- 是否需要我代为部署：{{需要（我提供 wp-admin 账号）/ 不需要，只在本地验收}}
- 其它说明：{{例：按 templates/打包命令.md 打包，zip 需排除 node_modules}}
```

---

## 二、开工前后你自己要确认的 3 件事

1. **Node 与联网可用**：本机已装 Node（建议 20+）与 npm，且能联网执行 `npm install`——Tailwind / daisyUI 依赖必须下载后才能构建样式。
2. **WordPress 站点可访问主题目录**：你能读写在目标站点的 `wp-content/themes/` 下创建主题目录（本地环境或 FTP / 面板均可），且站点的 WordPress / PHP 版本符合技能包要求。
3. **给我后台账号才能部署**：若需要 AI 直接部署或调整后台设置（固定链接、SEO 插件选项、指定「文章页」等），必须先提供 wp-admin 账号；否则 AI 只在本地交付主题文件，由你自己上传。