WordPress 网站：从空文件夹到生产环境
本工具包是一个方法加一个启动项目。它是在一个真实客户付费使用的多语言预订网站上学习得来的。请按顺序跟随各个阶段。每个阶段以一道“门禁”结束：只有当门禁条件为真且证据已书面记录时，才能离开该阶段。
1. 查找项目当前所在位置
- 在项目根目录中查找
SITE_STATUS.md。- 如果缺失：项目尚未启动。请使用 wp-kickoff。
- 如果存在：读取它。当前阶段是第一个门禁未勾选的阶段。
- 读取
AGENTS.md（项目规则），然后读取SESSION_LOG.md和DECISIONS.md中最新几行。 - 用两行告知所有者：当前阶段，以及下一步具体操作。
2. 各阶段
| # | 阶段 | 技能 | 离开门禁条件（证据写入 SITE_STATUS.md） |
|---|---|---|---|
| 1 | 启动 | wp-kickoff | 所有者批准简报；锁定决策已记录；私有仓库；凭据按名称列出 |
| 2 | 设计 | wp-design | 静态原型已签署（截图+日期）；令牌已设置；字体自托管 |
| 3 | 构建 | wp-build | 本地站点运行；核心插件+子主题激活；通过核心函数渲染真实项目；咨询在转发前先保存；结构测试通过 |
| 4 | 内容 | wp-content | 每个公开页面均有所有者批准的文案和真实照片；法律页面存在；无未经批准的 AI 文本 |
| 5 | SEO 与语言 | wp-seo | 标题、描述、规范链接、结构化数据和 hreflang 测试通过；旧 URL 重定向映射；每种额外语言通过试点 |
| 6 | 质量 | wp-quality | 完整测试套件通过；0 个可访问性违规；在预发布环境上满足性能预算 |
| 7 | 发布 | wp-ship | 预发布环境与线上环境一致；安全加固已应用；上线审查器 PASS；切换完成；观察 7 天 |
| 8 | 运营 | wp-operate | 自动备份含离线副本；完成一次恢复演练；更新和告警流程已编写 |
- 将阶段工作移交流程交给构建代理人（Antigravity、Codex、或其他 Claude）：wp-task-file。
- 合并前审查：代理人 wp-rules-reviewer。上线前：代理人 launch-auditor。
3. 硬规则（每个阶段、每个代理人都遵守）
- 插件优先。 逻辑、数据、政策文本、表单、结构数据和 SEO 均位于核心必用插件中。主题负责布局。皮肤负责外观。重新设计不得丢失任何功能。
- 模板中不使用硬编码的卡片、价格或别名。 查询内容类型并通过核心的渲染函数渲染，以便 CMS 编辑后处处生效。
- 线索先保存。 表单提交至
admin-post.php并携带 nonce。网站将线索存储在自己的数据库中，然后转发。页面中不出现 API 密钥或第三方端点。 - 无虚假证据。 永远不要展示无人能证明的评分、评论数量或推荐语。导入的或“遗留”的评论数字在可证明之前视为虚假。
- 真实照片 用于任何具名地点、房间、产品或人物。AI 图像仅作为通用风景，命名为
ai-*，记录在案，并且永远不要呈现为“这是你的房间”。 - 事实来自所有者。 价格、政策、包含项和安全事实绝不编造。AI 文案在所有者批准前仅为草稿。未知项 =
PENDING-<谁>。 - 未经分支、本地测试、差异对比和人工合并，不许将 AI 编写的 PHP 发布到生产环境。 遵循 WordPress 编码标准。所有内容均加前缀。
- 无页面构建器。无 Google Fonts 调用。 自托管字体：一家德国法院判决因从 Google 加载字体泄露访客 IP 地址而需赔偿。
- 预发布环境和本地环境绝不能编入索引，也绝不能向真实客户发送邮件。
- 绝不能为通过测试而削弱测试： 不得删除、跳过或重新生成快照。重命名测试需经所有者同意。
- 部署权属于所有者。 从提交开始，通过
scripts/deploy-safe.sh：先试运行，先备份，live一词由人类输入。 - 数据库是内容。 仅通过可审查的变更文件和带试运行的受保护脚本更改数据库。每次更改数据库前均需备份。
- 密钥绝不可进入 git、日志、提示或页面。
CREDENTIALS_INVENTORY.md列出名称以及每个密钥的存放位置，绝不列出值。 - 一个结构化数据所有权者（通常是 SEO 插件）。未提供价格时绝不输出
Offer。
4. 首先询问所有者
- 安装插件、主题、工具或付费服务（页面构建器：绝不）。
- 对价格、货币、政策、品牌名称或徽标的任何更改。发布新语言。
- 任何涉及 DNS、Cloudflare、托管、预发布环境或线上环境的操作。破坏性数据库或文件命令。
- 将代码或客户内容发送给第三方 AI API。
5. 工作方式
- 一次一个阶段，一次一小步。每完成一个有意义的步骤后提交（约定式提交）。
- 分支、本地测试、差异对比，然后所有者合并。除非所有者明确要求，否则代理人绝不推送、合并、部署或
ssh到服务器。 - 每个决策均写入
DECISIONS.md（日期、决策人、原因）。每次会话结束时在SESSION_LOG.md中添加一行。 - “完成”意味着已检查：打开页面、运行测试、读取服务器响应。绝不相信其他代理人的“已解决”而不自行检查。
6. 来自其他工具包的有用技能（如果已安装）
- agent-skills-kit：
wordpress-modern、wp-plugin-development、wp-wpcli-and-ops、wp-performance，用于 WordPress API 细节。 - agent-loop-kit：
supervised-build、agent-supervisor，用于带门禁和审查者的无人值守构建循环。