把谷歌官方指南做成了AI技能，还顺手修了个bug

…
AI, 有用的工具, SEO
文章目录

前段时间"AI 搜索"这个概念是真的火，朋友圈里到处是"AEO"“GEO"“答案引擎优化"之类的词，好像不追一下就要错过一个时代。

谷歌官方也下场了，发了一篇专门讲怎么针对 AI 搜索优化网站的指南，而且明确说了一句话：什么 AEO、GEO，本质还是 SEO，别整那些花活。

我当时就在想，既然官方的"正确答案"就这么一篇，那不如把它做成一个 AI 技能（skill）。以后不管是我自己，还是别人，想让 AI 帮忙审计网站适配 AI 搜索的情况，AI 直接照着官方标准来，而不是东拼西凑的网上玄学。

所需材料

  • 一个能装 skill 的 AI 终端（我用的是 opencode）必须
  • 谷歌官方指南 AI 优化指南 非必须,已经内置官方指南
  • 一点折腾的耐心 必须

先想清楚要做什么

动手之前，被一个叫 grill-me 的 skill 按在椅子上审问了一顿。

它的玩法很狠：把你脑袋里模糊的想法，一个分支一个分支地往下问，每个问题都附上它推荐的答案，你不同意就换。十几轮下来，你原本"大概做个工具"的想法就被逼成了清晰的规格。

几个关键决策当时是这么定的：

  • 做成主动审计型，不是知识库。用户给个网址或者 HTML 文件，AI 照着指南逐条查，出一份报告；而不是光会"给你讲讲”。
  • 输入支持两种：有网址抓网址，没有网址直接给 HTML 文件也行。先只做单页面审计，站点级的以后再说。
  • 指南内容内嵌进 skill，同时联网可用时核对最新版。因为官方文档经常更新，但也不能每次都依赖网络。
  • 报告双层结构：能客观验证的（robots、canonical、图片 alt、JS 渲染……）给"通过/警告/失败"加证据；主观判断的（内容是不是"非同质化”）明确标注"判断型结论"，不装权威。
  • 识别网站类型：先判断是内容站、电商站还是本地商家，再决定查哪些项，避免无关项刷屏。
  • 触发条件保守：只有明确要"AI 搜索审计"才触发，普通 SEO 优化请求不掺和。

这里最反直觉的一条，其实是"保守触发"。因为 skill 一旦写得太激进，什么请求都往上凑，反而会在不该用的时候帮倒忙。这个后面评估的时候真的验证到了。

怎么验证它真有用

光写出来不算完。skill-creator 的流程是：起草 → 拿真实感测试用例跑一遍 → 对比"没这个 skill 的 AI"的表现 → 出报告。

我设计了 4 个用例：

  1. 一个内容站的博客页面，让它审计
  2. 一个已经加了 llms.txt 和结构化数据的页面（典型的"踩雷"场景）
  3. 一个电商商品页
  4. 一个反例：只说"做常规 SEO 优化"，不该触发

结论非常有意思。带 skill 的 AI 在三个判定场景全过，而"裸奔"的 AI 只有 0% 到 33%。

最夸张的是第二个用例。那个网站已经加了 llms.txt，用户问"还有别的办法提升曝光吗"。没有 skill 的 AI 直接给了 P0 建议：扩展 llms.txt、新增 llms-full.txt、补 FAQPage/HowTo 结构化数据来提升 AI 引用……

然而官方指南白纸黑字写着：llms.txt 是误区，谷歌搜索会忽略它，不加分不减分；AI 搜索也不需要结构化数据。等于裸奔 AI 给的建议，全部踩在官方明令禁止的坑里。

带 skill 的 AI 则准确指出：llms.txt 是白费功夫，别指望它影响谷歌搜索，真正该做的是内容非同质化、技术结构和 Search Console 自查。

这就是"正确答案内嵌 vs 网上玄学"的差别，一眼就能看出来。

1785904635781

1785904625829

顺手修了个 bug

评估报告要用一个叫 eval viewer 的网页工具看。打开一看，中文全变成了 \u516d\u3001\u5b8c\u6574 这样的乱码字符串。

排查半天，根因很妙：某份测试报告里，恰好有示例代码，里面写了一行字面量 </script>。而 viewer 是把所有数据嵌进 HTML 的 <script> 标签里的。浏览器一看到内容里的 </script>，以为脚本块提前结束了，剩下的转义 JSON 全被当成普通文字显示在页面上。

修起来就两行：把 </script> 转义成 <\/script>，顺便让 JSON 直接输出 UTF-8 而不是 \u 转义。用真实浏览器验证，乱码没了，控制台零报错。

所以说，折腾的路上总会捡到意想不到的 bug。

怎么用

skill 已经开源上传到 GitHub，一行命令就能装：

npx skills add youerning/agent-garden --skill google-ai-search-audit

装完之后怎么触发？很直白，直接说人话就行，比如：

  • “帮我审计一下 https://myblog.com 在 Google AI 搜索里的表现”
  • “用 AI 搜索审计帮我查一下这个页面”（然后把 HTML 拖给它）
  • “我的电商站想适应 AI 搜索，帮我看一遍”

它干的事是这样的：

  1. 拿到网址就抓 HTML，拿不到就用你给的文件
  2. 联网可用就顺手核对下官方指南最新版（走 https_proxy 环境变量，不写死，失败就回退内嵌快照）
  3. 判断网站类型，加载对应的检查项
  4. 逐项给结论：通过 / 警告 / 失败 / 不适用，每一项都带证据和指南出处
  5. 输出固定格式的审计报告：概览、客观检查表、主观评估、优先级整改清单（P0/P1/P2）、需用户自查、已确认的无用功

最后那节"已确认的无用功"是我最喜欢的设计——直接告诉用户哪些事不用做：别做 llms.txt、别为 AI 拆内容、别为 AI 改写、别堆关键词、别为 AI 搜索加结构化数据。省下的时间，才是真的赚到。

总结

这次折腾的收获，说大不大，说小不小：

  1. 官方文档是最好的"正确答案"来源，但得有人把它塞进 AI 脑子里，AI 才不至于一本正经地胡说。
  2. 技能这类东西，价值在评估流程里才能看清——没有基线对比，你根本不知道它是不是在帮倒忙。
  3. 一个好用的工具，背后通常藏着一堆流程和踩坑，而坑会帮你修掉更多 bug。

如果这个 skill 对你有用，或者你也在折腾 AI 技能，欢迎交流。

最后在opencode使用deepseek v4 flash模型测试一下

最后的最后

关注一下再走呗^_^