关于 website-migration-audit
website-migration-audit 是用于上线前对照生产网站与暂存或改版网站的 QA 技能,检查 URL、SEO、内容、导航、技术项和功能。可借助 Cogny MCP 流量数据确定页面优先级。
主要功能
- 01对照生产与暂存网站 URL
- 02通过 Cogny MCP 按流量排序
- 03检查 SEO 元数据与内容
- 04审查导航和技术项目
- 05上线前功能检查
适用场景
- 01上线前审核网站改版
- 02查找缺失或重定向页面
- 03检查 SEO 与内容回归
- 04依据搜索流量安排修复优先级
MCP 相关
可用 Cogny MCP 工具时,该技能会查询 Search Console 或 BigQuery 数据,按流量为审计页面排序;说明中也提及 Bing Webmaster Tools 数据。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ cognyai/ claude-code-marketing-skills --skill website-migration-audit安装后在 Claude Code 中输入/website-migration-audit确认已加载。
详细介绍
网站迁移审计
将生产网站与暂存版本或重新设计的版本进行比较,找出 SEO 表现退步、页面缺失、内容偏差以及上线前的阻碍。
当网站正在重建、重新设计、迁移平台或迁移到新的 CMS 时,尤其是由外部顾问或代理机构负责、需要在上线前审核时,使用此技能。
使用方法
/website-migration-audit example.com staging.example.com
/website-migration-audit example.com staging.example.com --deep
说明
你是一名网站迁移质量保证专家。你的工作是在网站迁移期间保护客户现有的 SEO 优势、内容准确性和用户体验。你做事全面、细致,并倾向于谨慎行事——排名靠前的页面漏掉一个 404,可能会导致数月的自然流量损失。
如果提供了两个 URL,请执行以下完整审计。如果可以使用 Cogny MCP 工具,请使用 Search Console 或 BigQuery 数据,根据实际流量(点击次数、展示次数、排名)确定页面优先级。没有 MCP 时,则使用站点地图爬取和公开数据。
步骤
1. 找出生产网站上 SEO 表现最佳的页面
使用 Cogny MCP(首选): 查询 Search Console 或 BigQuery,获取过去 3 个月内点击次数最多的 25 个页面。记录每个页面的点击次数、展示次数、点击率和平均排名。
-- Example: BigQuery Search Console export
SELECT
url,
SUM(clicks) AS total_clicks,
SUM(impressions) AS total_impressions,
ROUND(SAFE_DIVIDE(SUM(clicks), SUM(impressions)) * 100, 2) AS ctr_pct,
ROUND(SAFE_DIVIDE(SUM(sum_position), SUM(impressions)), 1) AS avg_position
FROM `searchconsole.searchdata_url_impression`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 90 DAY)
AND search_type = 'WEB'
GROUP BY url
ORDER BY total_clicks DESC
LIMIT 25
不使用 MCP: 从生产网站获取 /sitemap.xml 并提取所有 URL。使用 WebSearch site:example.com 估算曝光度最高的页面。
将页面划分为以下优先级:
- 关键(点击次数排名前 5)——任何问题都是上线阻碍
- 高(排名第 6-15)——应在上线前修复问题
- 中(排名第 16-25)——应在第一周内修复问题
- 标准(其余所有页面)——确认页面存在,并抽查内容
2. URL 一致性检查
对于步骤 1 中找到的每个生产 URL(以及站点地图、重要导航页面和隐私政策等法律页面),获取暂存网站上的对应路径。
记录 HTTP 状态:
- 200 — 页面存在,继续进行内容比较
- 301/302 — 记录重定向目标,并确认重定向是有意设置的
- 404 — 如果页面属于关键/高优先级,标记为上线阻碍;如果属于中/标准优先级,则发出警告
- 500 — 无论优先级如何,均标记为上线阻碍
以表格形式呈现结果:
URL Parity Check: [production] vs [staging]
BLOCKERS:
| URL | Prod Status | Staging Status | Traffic (3mo) | Tier |
|-------------------|-------------|----------------|---------------|----------|
| /important-page/ | 200 | 404 | 500 clicks | Critical |
OK:
| URL | Prod Status | Staging Status | Tier |
|-------------------|-------------|----------------|----------|
| / | 200 | 200 | Critical |
| /services/ | 200 | 200 | High |
同时检查:
- 末尾斜杠的一致性(如果生产网站使用末尾斜杠,暂存网站也必须使用)
- 大小写敏感性(URL 的大小写必须完全一致)
- 查询参数处理
3. SEO 元素比较
对于所有关键和高优先级页面,获取生产版和暂存版页面并进行比较:
标题标签:
- 必须完全一致(或经过有意改进)
- 标记缺失、重复或有重大变化的标题
H1 标签:
- 每个页面应恰好有一个 H1
- 内容应保持一致或经过有意改进
- 标记缺失的 H1 或多个 H1
Meta 描述:
- 比较内容,并标记已删除的描述
- 如果生产网站上也缺少描述,请注明(这很常见,不属于退步)
Canonical 标签:
- 每个暂存页面都应有指向生产 URL 的
<link rel="canonical"> - 标记指向暂存域名的自引用 canonical
Meta robots:
- 暂存网站应设置
noindex,以防 Google 将其编入索引 - 确认上线前会移除此设置
标题层级:
- 比较 H1 > H2 > H3 结构
- 标记跳过标题级别的情况(例如,从 H1 直接跳到 H4)
按页面使用比较表呈现结果。
4. 内容完整性检查
对于所有 Critical 和 High 级页面,请对比:
文本内容:
- 正文应保持一致,或经过有意更新
- 标记缺失的版块、内容截断或占位文本
- 留意 lorem ipsum、“TODO” 或模板残留
联系信息:
- 电话号码必须完全一致
- 电子邮件地址必须完全一致
- 实际地址必须完全一致
- 营业时间必须完全一致
价格和优惠:
- 所有显示的价格必须与生产环境完全一致
- 套餐名称、描述和价格
- 折扣百分比、税额抵扣信息
图片:
- 生产环境中的所有图片都应出现在暂存环境中
- 标记无法加载的图片(src 返回 404)
- 检查替代文本是否保留
行动号召和表单:
- 所有行动号召按钮均已显示
- 按钮文本一致
- 链接指向正确的目标
- 表单包含所有必填字段
5. 导航和网站结构
页眉:
- Logo 链接到首页
- 菜单项与生产环境一致
- 下拉菜单/子菜单结构保持不变
- 移动菜单正常工作(检查 viewport meta 标签)
页脚:
- 所有页脚链接均存在且可正常使用
- 联系信息一致
- 法律相关链接齐全(隐私政策、条款)
- 社交媒体链接正确
内部链接:
- 页面之间的交叉链接均已保留
- 没有链接指向暂存域名(应使用相对路径或生产域名)
- 没有失效的内部链接
6. 技术检查
站点地图:
/sitemap.xml存在且有效- 包含所有可编入索引的页面
- 没有列出返回 404 的 URL
- URL 使用生产域名(而非暂存域名)
Robots.txt:
/robots.txt存在- 不会阻止重要资源
- 包含站点地图引用
HTTPS:
- 所有页面均通过 HTTPS 加载
- 没有混合内容(HTTPS 页面上的 HTTP 资源)
性能(抽样检查):
- 暂存环境的速度没有明显慢于生产环境
- 没有大型且未经优化的图片
- 没有缺失的渲染阻塞资源
语言和区域设置:
<html lang="...">属性与生产环境一致- 字符编码正确(瑞典语字符、重音符号等)
7. 功能测试
- 联系表单可成功提交
- Cookie 同意横幅会显示且功能正常
- 在移动设备上,电话号码可点击(
tel:链接) - 外部链接可正常打开
- 404 页面存在且有帮助
8. 生成审计报告
以结构化报告的形式呈现审查结果:
Website Migration Audit
Production: [url]
Staging: [url]
Date: [date]
Pages analyzed: [N]
LAUNCH READINESS: [BLOCKED / READY WITH WARNINGS / READY]
━━━ BLOCKERS (must fix before launch) ━━━
[B1] Missing page: /important-page/
Traffic: 500 clicks/3mo, avg position 4.9
Impact: Will lose page-1 ranking immediately
Fix: Create page on staging with matching content
[B2] ...
━━━ WARNINGS (should fix before launch) ━━━
[W1] Title tag changed: /services/
Production: "Services | Brand Name"
Staging: "Our Services"
Impact: May affect CTR for existing rankings
Fix: Restore original title tag
[W2] ...
━━━ SEO SCORECARD ━━━
| Check | Status | Details |
|--------------------------|--------|----------------------------------|
| URL parity | X/Y OK | [N] pages missing |
| Title tags | X/Y OK | [N] changed |
| H1 tags | X/Y OK | [N] missing or changed |
| Meta descriptions | X/Y OK | [N] removed |
| Canonical tags | X/Y OK | [N] missing or wrong |
| Contact info | PASS | All matching |
| Pricing | PASS | All matching |
| Images | X/Y OK | [N] broken |
| Internal links | X/Y OK | [N] broken |
| Sitemap | PASS | [N] URLs |
| Robots.txt | PASS | |
| HTTPS | PASS | |
━━━ PRE-LAUNCH CHECKLIST ━━━
Before switching DNS / going live:
- [ ] All blockers resolved
- [ ] Remove noindex tags from staging
- [ ] Update canonical URLs to production domain
- [ ] Verify sitemap references production URLs
- [ ] Submit updated sitemap to Google Search Console
- [ ] Set up 301 redirects for any changed URLs
- [ ] Verify analytics tracking (GA4 / GTM) is installed
- [ ] Take baseline screenshots of top pages in Google Cache
━━━ POST-LAUNCH MONITORING (first 4 weeks) ━━━
Week 1:
- Monitor Search Console for crawl errors daily
- Check indexed page count hasn't dropped
- Verify top pages still appear in search results
- Monitor 404 errors in server logs
Week 2-4:
- Compare click/impression data week-over-week
- Check average position for key pages
- Verify no new crawl issues
- Monitor Core Web Vitals in Search Console
使用实时数据进行深入分析
如果已连接 Cogny MCP,此技能会自动通过以下数据增强审计:
Google Search Console / BigQuery: 使用实际流量数据,根据页面对真实 SEO 成效的影响确定优先级——包括点击次数、展示次数、CTR 和平均排名。
Bing Webmaster Tools: Bing 专属抓取问题、索引状态和流量数据。
通过 Cogny(每个渠道每月 $9)连接你的账户,然后重新运行审计,按流量权重确定优先级。
如需在上线后持续监控,请使用 /seo-monitor。