第 1 阶段:启动
目标:生成一份关于业务的“唯一真相文档”,以及一个包含方法所期望的所有文件的空项目。尚未进行任何设计或构建。
步骤
- 是否已有在线站点? 如果是,将其视为正在运营的业务,而非挂起域名。首先进行清点(
references/discovery-brief.md,“现有站点”部分):- 所有 URL(通过站点地图)、表单、支付步骤、博客文章和联系信息;
- 其 Search Console 数据(如果所有者可以分享);
- 当前哪些功能在赚钱。重建时必须保证所有功能继续正常工作。 礼貌爬取:先阅读使用条款(robots.txt 并非许可),每次请求之间至少等待 2 秒。
- 需求简报。 按
references/discovery-brief.md中的问题提问,并将答案写入docs/BRIEF.md。每个事实需标注来源(所有者、文档、爬取)。如果某个事实未知,写为PENDING-<谁>。切勿猜测。 - 技术选型。 从
references/stack.md中的默认配置开始。仅在有令人信服的理由时才更改某一层,并将改动记录在DECISIONS.md中。 - 创建项目 使用工具包的脚手架(位于此技能所在文件夹的上两级):
bash <kit>/bin/wp-site-new --name "Acme Tours" --slug acme-tours --prefix acme \ --domain example.com --dir ~/sites/acme-tours --gitslug:小写字母和连字符。用于命名 DDEV 项目、文件夹和文本域。prefix:2 到 12 个小写字母或数字。所有函数、选项、文章类型、元键、钩子和 nonce 都以<prefix>_开头。
- 填写
AGENTS.md:- 网站是什么;
- 谁批准设计和客户文案;
- 已锁定的决策;
- 特定于该业务的硬性规则,例如受监管的声明、需要展示的许可证,或所有者不希望出现的词汇。
- 私有远程仓库,第 1 天设置。 所有者创建私有仓库并推送。一旦本地站点存在(第 3 阶段),运行
scripts/backup.sh并在另一台机器上保留一份副本。 - 凭证清单(
docs/reference/CREDENTIALS_INVENTORY.md):- 列出每个账户(域名注册商、DNS、主机、SMTP、分析工具、Search Console、支付、CDN);
- 写明每个密钥的存放位置;
- 仅列出名称,切勿写值。
- 在
SITE_STATUS.md中勾选启动门禁,并附上证据:简报的批准日期、首次提交的 SHA、远程仓库名称。
门禁
-
docs/BRIEF.md已获所有者批准(日期) - 已锁定的决策和业务硬性规则已写入
AGENTS.md - 项目已创建并提交;私有远程仓库已存在
- 凭证清单已开始填写(仅名称)
- 替换在线站点时:URL 和功能清单已保存在
docs/data/legacy/中(或填写“不适用” n/a)
我们曾遇到的陷阱
- 将“切换”视为简单的 DNS 更改,而旧站点当天仍在处理付费预订。
- 旧站点的评论数量(“1,118 条评论”)经查是编造的。请勿迁移这些虚假数据。
- 通过 Cloudflare 代理域名,而旧主机按 IP 限速。主机仅看到 Cloudflare 的 IP,导致真实访客收到 429 错误。在启用代理前,请检查源站的主机限制。
- 轻信其他代理的备注说“已解决”。修复方案未推送、未测试、未部署。请验证真实情况。
- 有人在代理聊天中粘贴了 API 密钥。代理见过的密钥必须轮换。