用途:review-seo 是 agentic-workflow 评审包中的内部 SEO 审查环节,由 review-change 或 product-audit 在对话中组合调用,作为路由步骤内联执行。它只报告发现,绝不编辑或重构代码。
主要能力:按固定清单逐项评估,包括先读取项目 SEO 文档(如 docs/frontend/SEO.md),若产品无公开网页则全部标记 n/a 并说明原因;检查新增或变更的公开页面是否有唯一标题与符合项目声明长度的 meta description;新路由的 canonical URL 是否正确、无意外重复;可索引意图与实际状态是否一致(robots/noindex/sitemap);每页是否只有一个 h1 且标题层级不跳级;结构化数据是否对项目声明的内容类型有效(运行验证器时引用输出);变更导航中的链接是否可爬取(真实 href 而非点击处理器);变更页面图片是否有描述性文件名/alt(按 SEO 文档要求);主要内容是否存在渲染阻塞回归(项目声明 SSR/SSG 时内容应在无 JS 下存在)。
使用方式:调用方传入 diff 或路径/glob,默认对比当前变更与默认分支,并在返回表格顶部声明范围。返回固定格式块,包含范围、发现表格(编号、发现、严重度、证据、建议修复)、清单统计、摘要和 PASS/FAIL 决定。
适用场景:适用于有公开网页表面的项目在变更评审时进行 SEO 合规检查。
限制:仅报告发现,不修改代码;只报告会改变合格用户结果或违反项目明确声明规则的问题,不报告注释/标点错别字、纯格式漂移、无引用规则的风格偏好或超出 SPEC 命名场景的假设性健壮性;空表格加 PASS 是良好变更的预期结果,不得填充表格;存在未解决的 critical 或 major 发现则 FAIL,minor 不阻塞,转交调用方分诊步骤。完成条件是每个清单项都有证据(file:line 或命令输出)或明确标记 n/a 及原因,并返回固定格式块,不更改任何代码。