seo-regression-validator

用途

SEO Regression Validator 用于验证（而非实施）SEO 与 LLM 可读性相关主张。它的定位是：在已有技术 SEO / Schema 指导之后、宣称某个站点或技能输出完成之前，对声明进行可复核的核验。它会检查线上 HTML、本地测试夹具和生成的产物，避免出现未经抓取就报告成功的情况。

主要能力

线上 HTML 与本地夹具检查。
通过/失败严重级别（severity）模型。
带时间戳的证据报告。
Schema 与 head 元数据检查。
公开产物可达性检查。
回归报告模板。
针对缺失 JSON-LD、重复 canonical、缺失图片、伪造报告的负面测试。

默认判定为严重（Critical）的项目

缺失 <title>；
缺失 meta description；
canonical 缺失或重复；
预期应有 schema 的页面没有 JSON-LD；
JSON-LD 无效；
NewsArticle 没有可用图片；
线上检查时公开页面被阻止或无法访问；
报告在未抓取或未读取目标的情况下声称成功。

默认判定为警告（Warning）的项目

预期存在多语言等价页面时缺失 hreflang；
缺失 OG/Twitter 社交标签；
缺失 RSS autodiscovery；
缺失 viewport；
存在 article schema 但缺少文章 meta 标签；
预期存在 BreadcrumbList 但没有可见面包屑；
未测量性能指标。

使用方式

工作流程如下：

定义目标 URL 或夹具文件。
记录时间戳、目标、方法与 user agent。
在不改动目标的前提下获取或读取目标。
当 HTML 可用时，使用 scripts/audit_static_seo.py 运行确定性检查。
区分严重失败、警告与跳过项。
记录跳过项，而不是把它们当作通过。
生成或更新 seo-regression-report.json 以及人类可读的验证摘要。
将实施修复路由给相应的专家。

运行前应阅读 references/regression-checklist.md 再执行广泛审计。

验证命令示例（保持原样）：

python3 <codex-skills-dir>/senior-skill-architect/scripts/lint_production_skill.py ./skills/seo-regression-validator
python3 ./skills/seo-regression-validator/scripts/audit_static_seo.py ./skills/seo-regression-validator/fixtures/good-news.html
python3 ./plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py .

前向测试（forward tests）位于 evals.json。

输出形态

返回内容包含：

所检查的目标；
严重发现；
警告；
跳过项；
证据路径或 URL；
每项修复的实施负责人。

适用场景与限制

适用场景是：需要对站点或技能输出的 SEO / LLM 可读性主张进行事后核验，并产出可追溯的证据报告。

该技能不负责（Does Not Own）：实施 SEO 修复、需要凭据的 Search Console 数据、分析导出、外部权威放置、改动目标网站。

安全与隐私边界：不要改动目标站点；除非用户为本次任务明确提供，否则不要使用凭据；不要在报告中存储 cookie、token、原始私有分析数据、原始 IP 日志或私有 Search Console 行；不要仅凭一次 HTML 检查就断言排名、索引、引用或爬虫行为。

其他事实（如具体价格、收费模式、支持平台等）暂未提供。