这篇讲什么
一个可复用的 Claude Code prompt 和工作流，把”我该审一次 SEO”变成两小时具体 session，结尾产出三个上线修复。痛点：传统 SEO 审计扔给你 300 条发现，多数只影响两个页面，最后什么都没改。在自己仓库里用 Claude Code，可以按影响页数排序、修 top 3 并 review diff、重新 build——全程不离开编辑器。
本文涉及的工具 / 概念：
- Claude Code: Anthropic 的命令行 AI agent；上半场只读审计，下半场谨慎编辑。
- 内容数据注册表:
src/data/categories.ts、src/data/hubs.ts这类描述站结构的文件；指 agent 看这些是质量最大的杠杆。 - 审计脚本: 你现有的内容校验（如
npm run audit:content），每次修复后当真相源用。
这篇适合谁看
用 Astro / Next.js / Hugo 的独立内容站站长，已经装了 Claude Code 并写了 CLAUDE.md。双语站（EN + ZH）尤其值——hreflang 和翻译对齐会成倍放大面积。
什么时候适合用
上线前——趁修复成本还低，抓掉大头问题。然后每 90 天一次，因为模型、内容、Google 偏好都在漂。大型内容迁移或模板变更后也跑一次。
开始前准备
- 提交工作树。干净基线下 review agent 的 diff 容易得多。
- 确认审计脚本今天能干净跑通。跑不通先修；否则分不清是 agent 改坏的还是本来就坏。
- 定范围：审哪些类目、语言、模板。“全部”不是范围。
- 准备好一组典型文章——agent 把这些当模式读，不读整库。
具体步骤
- 在你的站仓库打开 Claude Code。确认 CLAUDE.md 提到目录布局和审计脚本命令。
- 跑审计 prompt：
跑 SEO 审计。读 src/data/categories.ts、src/data/hubs.ts、每类 5 篇样本文章。输出：metadata 问题、薄内容候选、内链缺口、hreflang 问题。先别修。 - 复核发现。按”影响页数”排序，聚焦影响 10+ 页的。单页问题不值得开 agent session。
- 挑 top 3。每条问：“修问题 1，只动列出的文件。apply 前先 diff。其他文件不许碰。” 看完 diff 再批准。
- 每修一条跑
npm run audit:content+npm run build。两个都过才下一条。 - 每条问题一个 commit。一条一 commit 让事后回归回滚很精确。
- session 结尾让 agent 总结：修了什么、推后了什么、注意到什么新模式。贴进审计日志。
第一次实操怎么跑
- 选一个有 30-50 篇文章的类目。比整站小、够代表性。
- 只在那个类目跑步骤 2 的审计 prompt。发现存进 Markdown 文件。
- 端到端只修一条（步骤 4-6）。记下 agent 哪里不清楚、哪里追问。
- 把对 prompt 措辞的领悟更新到 CLAUDE.md——它懂的术语、反复漏的文件。
完成后检查
- Agent 真读了你的数据注册表，还是猜的？翻它回答里有没有提到
categories.ts里的字段名——有就是真读了。 - 发现是具体的（文件路径 + 行号 + 可复现问题）还是通用的（“有些文章内容薄”）？通用就反推到具体。
- 每修一条，
audit:content的问题数真的降了吗？没降就是表面修复。 - Diff 在范围内吗？让它修 metadata 不该改正文。改了说明 prompt 太松。
怎么复用这套流程
- 把审计 prompt 存成 slash command
.claude/commands/seo-audit.md。每季度跑，不用重打。 - 用一张简单表追问题数随时间——季度、总发现、top 类目。趋势比单次审计有用。
- 每条修复的 prompt 也模板化：文件路径、精确改动、测试命令。跨类目复用。
- 每半年重测流程本身——Astro 默认、Google 指南、Claude 行为都会变。
建议的操作流程
开仓 → 审计 prompt → 复核发现 → 修 top 3 → 验证 → commit → 记日志。两小时、三个 commit、可测量的问题数下降。
FAQ
- Claude 懂我的站结构吗？: 先指 categories.ts / hubs.ts 注册表更好。加 CLAUDE.md 描述站约定。
- 会建议伤 SEO 的修复吗？: 会，每个 diff 都 review。最常见是标题里过度堆关键词。
- 小修复能跳过人工 review 吗？: 第一次不行。审过三次都干净，单行 metadata 这类可批量审。
- 没 CLAUDE.md 能用吗？: 能，但质量降。10 行写清数据文件位置也比没有强。
- 该花多久？: 含修复两小时。超过 4 小时说明范围太宽，缩到一个类目。
- hreflang 怎么办？: 审计抓显式不匹配；更深请看 AI hreflang 检查教程。
容易踩的坑
- 一个 prompt 让 Claude 修所有——太宽，拿到没法 review 的大 diff。
- 跳过发现的人工复核——再好的审计也有 10-20% 噪声。
- 每修一次不跑
audit:content+ build 验证——静默回归就溜过去了。 - 让 agent 自创约定而不是跟注册表——把它钉到
categories.ts和hubs.ts。 - 一次审整站——先拿一个类目把模式摸清再放大。
- 把审计输出当终稿——它是 triage 清单，不是修复清单。
相关阅读
- SEO 审计 Prompt
- AI 审 Astro 站
- AI 检查你的 hreflang 配置（双语 / 多 locale）
- 用 AI 批量生成 Meta Description（小心）
- 怎么用 AI 分流 Search Console 问题
标签: #教程 #SEO #AI 编程 #Claude Code #SEO 审计