关于 review-seo
review-seo 是供 Agent 使用的内部 SEO 审查技能,用于依据项目要求检查变更。它只报告问题,不编辑代码,并检查页面元数据、索引状态、结构、链接、图片和渲染。
主要功能
- 01检查项目的 SEO 文档
- 02审查标题和元描述
- 03检查规范链接与索引状态
- 04审查标题层级和结构化数据
- 05检查链接、图片与渲染
适用场景
- 01审查公开页面变更的 SEO 影响
- 02检查路由是否按预期建立索引
- 03核对导航链接和页面元数据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gtrabanco/ agentic-workflow --skill review-seo安装后在 Claude Code 中输入/review-seo确认已加载。
详细介绍
SEO 审查(内部)
由 review-change / product-audit 在对话中编写——对于任何
Agent,请将此文件作为路由步骤内联执行。仅报告发现;绝不编辑,
绝不重构。
范围
调用方传入的差异或路径/Glob;默认审查当前变更与 默认分支之间的差异。在返回表格顶部注明范围。
检查清单(评估每一项——没有可选项;必须说明不适用的项目)
- ✓ 先阅读项目的 SEO 文档(例如
docs/frontend/SEO.md)——如果产品没有公开的 Web 界面,则所有项目均不适用,并说明原因 - ✓ 每个新增/变更的公开页面都有唯一的标题和元描述,且长度符合项目声明
- ✓ 新增/变更路由的规范 URL 正确(没有意外重复)
- ✓ 预期的可索引性 = 实际的可索引性(robots/noindex/站点地图状态符合页面用途)
- ✓ 每页只有一个 h1;标题级别不跳级
- ✓ 结构化数据符合项目声明的内容类型(运行验证器时引用验证器输出)
- ✓ 变更后的导航链接可爬取(使用真实 href,而非点击处理器)
- ✓ 变更页面上的图片具有描述性文件名/替代文本(SEO 文档有要求时)
- ✓ 主要内容没有出现阻塞渲染的回归(项目声明采用 SSR/SSG 时,无需 JS 即可呈现内容)
重要性门槛
只有当有能力的用户所获得的结果发生变化,或违反项目明确声明的规则时,才报告一行——在证据旁引用被违反的规则。不属于发现的情况:注释/标点错误、仅格式上的偏差、没有引用规则的风格偏好、超出 SPEC 所列场景的假设性稳健性问题。对于格式规范的变更,预期结果是空表格并附上 Decision: PASS——切勿填充表格。
严格按以下格式返回
REVIEW SEO — scope: <scope>
| # | Finding | Sev | Evidence | Suggested fix |
|---|---------|-----|----------|---------------|
| 1 | <what> | critical|major|minor | <file:line> | <smallest action> |
Checklist: <n> evaluated, <n> pass, <n> findings, <n> n/a (<which + why>)
Summary: <1-2 sentences>
Decision: PASS | FAIL
如果有任何关键或主要发现尚未解决,则判定为 FAIL;否则判定为 PASS。次要发现不会阻止通过——交由调用方的分流步骤处理。
完成条件
- 每项检查清单都须提供证据(文件:行号或命令输出),或明确标为不适用并说明原因。
- 返回上方的固定格式区块——不多不少,且未更改任何代码。
评论
支持 Markdown