ag-kit 仓库 SEO 基础技能E-E-A-T、Core Web Vitals 与可执行的站点审计实践【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit本文以 .agents/skills/seo-fundamentals/SKILL.md 为骨架完整解析其 E-E-A-T 框架、Core Web Vitals 指标、技术 SEO 与内容 SEO 原则、Schema 标记、AI 内容指南和排名因素优先级并结合 ag-kit 仓库内真实落地的元数据配置、robots/sitemap 生成逻辑与seo_checker.py审计脚本说明如何把这套原则变成可复制、可验证的工程实践。读完你可以掌握一套从「搜索引擎可见性原理」到「源码级落地检查」的完整 SEO 工作流。1. 技能文档定位这份 SKILL.md 讲什么seo-fundamentals是 ag-kit 仓库.agents/skills/目录下的一个标准技能Skill它的 frontmatter 明确定义了触发时机与使用边界name: seo-fundamentals description: SEO fundamentals, E-E-A-T, Core Web Vitals, and Google algorithm principles. when_to_use: When optimizing web pages for search engines, implementing meta tags, improving E-E-A-T, or fixing Core Web Vitals. allowed-tools: Read, Glob, Grep version: 1.0.0description说明该技能的覆盖面SEO 基础、E-E-A-T、Core Web Vitals 与 Google 算法原则when_to_use明确了调用场景为搜索引擎优化网页、实现 meta 标签、改进 E-E-A-T、修复 Core Web Vitalsallowed-tools限定该技能只读使用 Read / Glob / Grep 三个工具即这是一份「知识型」技能本身不写文件version1.0.0 表明它随仓库版本化管理可被 .agents/skills/ 下的技能编排机制引用。在 ag-kit 的 Agent 体系中该技能被 .agents/agent/seo-specialist.mdSEO/GEO 专家 Agent声明为依赖技能skills: clean-code, seo-fundamentals, geo-fundamentals并在 .agents/skills/geo-fundamentals/SKILL.mdGEO 基础中形成互补SEO 面向传统搜索引擎排名GEO 面向 AI 搜索引擎引用。二者叠加才构成 ag-kit 官方定义的「Content for humans, structured for machines」双目标策略。2. E-E-A-T 框架经验、专业、权威与信任E-E-A-T 是 Google 质量评估指南的核心框架技能文档将四个原则与其对应的信号整理如下原则Principle信号SignalsExperience经验第一手知识、真实案例Expertise专业资质证明、知识深度Authoritativeness权威反向链接、被提及、行业认可Trustworthiness可信HTTPS、透明度、准确信息在仓库中.agents/agent/seo-specialist.md 将这套框架进一步转化为可执行的「如何证明」清单Experience 用真实故事与一手经验体现Expertise 用证书与认证体现Authoritativeness 依赖反链与行业提及Trustworthiness 则落实为 HTTPS、透明度与真实评价。实践要点Experience 与 Expertise 的区别经验强调「你做过」专业强调「你懂且被认证」。二者都要在内容中显性化例如署名作者的实际项目经历 认证信息Trustworthiness 是地基没有 HTTPS、没有准确信息前三个 E-A-T 信号都会大打折扣权威需要外部证据反向链接和行业提及无法靠页面自说自话需要在内容策略中主动经营。3. Core Web Vitals三项核心性能指标Core Web Vitals 是衡量页面用户体验的官方指标集合技能文档给出三项核心指标及「良好」目标阈值指标Metric目标Target衡量内容MeasuresLCP 2.5s加载性能Largest Contentful Paint最大内容绘制INP 200ms交互性Interaction to Next Paint下一次绘制的交互延迟CLS 0.1视觉稳定性Cumulative Layout Shift累计布局偏移.agents/agent/seo-specialist.md 还补充了「好 / 差」的完整阈值边界可用于分级评估指标Good良好Poor较差LCP 2.5s 4.0sINP 200ms 500msCLS 0.1 0.25落地建议LCP主要受首屏最大元素图片、标题块影响预加载 LCP 资源、使用现代图片格式、控制服务器响应时间INP关注交互响应减少主线程长任务、合理拆分 JS、避免大型布局抖动CLS关注视觉稳定性为图片和广告位预留尺寸、避免在已有内容上方插入元素。ag-kit 的 Web 站点在根布局 web/src/app/layout.tsx 中通过viewport配置声明了width: device-width, initialScale: 1并设置双主题themeColor这是保证移动端渲染与视觉稳定性的基础配置同时ThemeProvider使用disableTransitionOnChange避免主题切换引发布局偏移从工程上呼应 CLS 的治理思路。4. 技术 SEO 原则4.1 站点结构可抓取性的四大支柱技能文档将站点结构要素归纳如下要素Element作用PurposeXML sitemap帮助爬虫抓取robots.txt控制爬虫访问Canonical 标签防止重复内容HTTPS安全信号ag-kit 的 Web 站点对以上四项均有源码级落地可直接对照验证1robots.txt—— web/src/app/robots.ts 用 Next.js MetadataRoute 动态生成import type { MetadataRoute } from next; export default function robots(): MetadataRoute.Robots { return { rules: { userAgent: *, allow: / }, sitemap: https://ag-kit.unikorn.vn/sitemap.xml, }; }它向所有爬虫userAgent: *开放全站allow: /并显式声明 sitemap 地址将「控制访问」与「引导抓取」一次配齐。2XML sitemap—— web/src/app/sitemap.ts 动态生成站点地图包含首页、全部文档入口以及 10 个指南示例guide/examples并为每条路由设置抓取频率与优先级const GUIDE_EXAMPLES [ brainstorm, plan, create, new-feature, debugging, test, preview, status, orchestration, deployment, ];每条路由的changeFrequencychangelog 为 weekly其余为 monthly和priority首页 1、文档页 0.9、其余 0.7说明站点地图不是「列出所有 URL」就完事而是用优先级和更新频率帮助搜索引擎理解页面权重层级。3Canonical 标签—— 在 web/src/app/layout.tsx 的 metadata 中声明alternates: { canonical: / }并通过metadataBase将相对路径解析为完整 URL防止因多域名、多参数导致的重复内容问题。4HTTPS—— 作为安全信号与信任信号站点 metadata 中所有 URLmetadataBase、Open Graphurl、sitemap 基地址均使用https://前缀属于 E-E-A-T 中 Trustworthiness 的技术承载。4.2 性能因素因素Factor影响Impact页面速度直接决定 Core Web Vitals移动端友好排名因素之一干净 URL提升可抓取性从源码结构看ag-kit 站点在 web/src/app/layout.tsx 中通过viewport设置 device-width 适配移动端并在构建配置层web/next.config.ts控制打包与静态资源优化同时manifest.ts提供 PWA 配置进一步改善移动端体验。这些都属于「移动端友好 页面速度」的工程侧支撑。5. 内容 SEO 原则5.1 页面元素最佳实践技能文档对每个核心页面元素给出了明确的规范元素Element最佳实践Best PracticeTitle 标签50–60 字符关键词前置Meta description150–160 字符有吸引力H1每页唯一包含主关键词H2–H6逻辑层级清晰Alt 文本描述性不堆砌关键词在 web/src/app/layout.tsx 中可以看到 ag-kit 对 Title 与 description 的工程化处理export const metadata: Metadata { title: { default: AG Kit - AI Agent Capability Expansion Toolkit, template: %s | AG Kit, }, description: A comprehensive collection of 47 skills, 20 specialist agents, rules, and production-ready workflows for modern AI coding assistants.,Title 模板defaulttemplate的组合意味着每个子页面只需提供自己的标题片段最终自动拼接为「页面标题 | AG Kit」既保证关键词前置又保证品牌一致性页面级覆盖例如文档区在 web/src/app/docs/layout.tsx 中覆盖为title: Documentation | AG Kit各文档子页面再进一步细化Alt 文本根布局的 Open Graph 图片/images/og-image.png也配置了描述性 alt与技能文档「描述性而非堆砌」的要求一致。5.2 内容质量因素因素Factor重要性Importance深度Depth全面覆盖主题新鲜度Freshness定期更新独特性Uniqueness提供原始价值可读性Readability清晰表达结合 .agents/agent/seo-specialist.md 的内容 SEO 检查清单可将这四个因素转为落地动作Title 优化至 50–60 字符、Meta description 控制在 150–160 字符、H1–H6 层级正确、内部链接结构完整、图片 alt 齐全——检查清单让「质量」变成可勾选、可审计的条目。6. Schema 标记类型让机器理解结构技能文档列出七类常用 Schema 标记及其适用场景类型Type用途UseArticle博客文章、新闻Organization公司信息Person作者档案FAQPage问答内容Product电商产品Review评分评价BreadcrumbList导航面包屑ag-kit 站点在 web/src/app/layout.tsx 中通过application/ldjson注入了完整的 JSON-LD 结构化数据直接展示了两类 Schema 的真实写法const jsonLd { context: https://schema.org, graph: [ { type: WebSite, id: https://ag-kit.unikorn.vn/#website, url: https://ag-kit.unikorn.vn/, name: AG Kit, description: Antigravity-first AI agent engineering kit ..., inLanguage: en-US }, { type: SoftwareApplication, id: https://ag-kit.unikorn.vn/#software, name: AG Kit, applicationCategory: DeveloperApplication, operatingSystem: Cross-platform, offers: { type: Offer, price: 0, priceCurrency: USD }, softwareVersion: 2026.8.31, author: { type: Organization, name: AG Kit Team } } ] };要点解读使用graph将多个实体WebSite SoftwareApplication组织在同一份 JSON-LD 中减少重复声明id提供实体标识帮助搜索引擎做实体关联entity consolidationSoftwareApplication 声明了applicationCategory、offers价格为 0 的开源项目、softwareVersion等结构化字段属于与技能文档「Article / Organization / Product」等类型呼应的实际案例。7. AI 内容指南Google 认可的内容生产方式技能文档用「该做/不该做」对照表给出了 AI 时代的内容准则✅ 该做Do❌ 不该做DontAI 起草 人工编辑直接发布原始 AI 内容加入原创洞见无价值地复制专家审阅跳过事实核查遵循 E-E-A-T关键词堆砌这与仓库中 GEO 技能的判断一致AI 引擎会优先引用「清晰、权威、易于抽取」的内容。落到工程层面可以将此准则与 .agents/agent/seo-specialist.md 的 GEO 检查清单配合使用——FAQ 段落、作者资质可见、带来源的统计数据、清晰定义、署名专家引言、「Last updated」时间戳——这些元素恰好也是人类读者信任感的来源实现「内容为人、结构为机」的统一。8. 排名因素优先级技能文档给出了一份按优先级排序的排名因素清单优先级Priority因素Factor1高质量、相关性强的内容2来自权威站点的反向链接3页面体验Core Web Vitals4移动端优化5技术 SEO 基础这份排序说明内容质量是第一位技术手段性能、移动端、robots/sitemap/canonical是排在其后的基础保障而反向链接则是内容价值的外部放大器。这也解释了为什么技能文档把大量篇幅放在内容与 E-E-A-T 上而将 robots.txt、sitemap 等技术项定位为「基础」fundamentals。9. 度量用数据验证 SEO 效果指标Metric工具Tool排名RankingsSearch Console、Ahrefs流量TrafficAnalyticsCore Web VitalsPageSpeed Insights索引状态IndexingSearch Console反向链接BacklinksAhrefs、Semrush实践顺序建议先在 Search Console 确认页面被正确索引 → 用 PageSpeed Insights 验证 Core Web Vitals 达标 → 用 Analytics 跟踪流量 → 用 Ahrefs/Semrush 观察排名与反链变化形成「索引 → 性能 → 流量 → 排名」的闭环验证。10. 仓库内落地seo_checker.py 一键审计技能文档还挂载了一个配套脚本 .agents/skills/seo-fundamentals/scripts/seo_checker.py把前文的原则变成了可执行的自动化审计。运行方式python .agents/skills/seo-fundamentals/scripts/seo_checker.py project_path该脚本Python 3无第三方依赖的核心设计如下1页面识别find_pagesis_page_file扫描**/*.html、**/*.htm、**/*.jsx、**/*.tsx跳过node_modules、.next、dist、build、test等目录只有位于pages/app/routes/views/screens目录、或文件名含page/index/home/about/contact等特征的文件才被视为公开页面最多审计 50 个文件。2六项检查check_pageTitle 标签页面缺少title或布局中无title/Head时告警Meta description缺少namedescription时告警Open Graph 标签缺少og:社交分享标记时告警H1 层级同一页面出现多个h1时告警对应「每页唯一 H1」原则图片 Alt图片无alt属性或alt空值时告警对应「描述性 alt」原则脚本中has_title/has_description/has_og三项只在is_layout检测到Head或head的布局/模板文件时才算问题避免对子页面重复告警——从源码结构看这是对 Next.js「layout 管 meta、page 管内容」架构的适配。3汇总输出按问题类型统计数量Issue Summary、列出受影响文件并输出结构化 JSON 结果{ script: seo_checker, project: /path/to/project, files_checked: 12, files_with_issues: 3, issues_found: 5, passed: false }passed为false时进程以退出码 1 结束因此可以直接接入 CI/本地校验流程。与之配套的 .agents/skills/geo-fundamentals/scripts/geo_checker.py 则专注于 AI 引用就绪度它只识别真正的公开路由入口Next.js App Router 下仅app目录中的page.tsx视为路由检查结构化数据、作者信息、日期、FAQ 段落等 GEO 要素两脚本构成「SEO 基础审计 GEO 引用就绪审计」的完整防线。11. 结语SEO 是一场长期游戏技能文档的收尾给出了整份文档的方法论总结SEO is a long-term game. Quality content technical excellence patience results.将这句话翻译成工程行动就是本文的完整闭环内容侧以 E-E-A-T 四原则组织内容遵循 Title/Meta/H1/Alt 规范按优先级清单分配投入技术侧配置 robots.txt 与 XML sitemap、声明 canonical 与 HTTPS、控制 Core Web Vitals 三项指标机器侧用 JSON-LD Schema 让实体可被理解同时兼顾 AI 引擎的 GEO 引用需求验证侧用仓库自带的seo_checker.py持续审计用 Search Console / PageSpeed Insights 度量效果迭代优化。这套「原理文档 源码落地 自动化审计脚本」的组合正是 ag-kit 把 SEO 从方法论变成可维护工程的最佳注脚。延伸阅读仓库内相关资源技能本体.agents/skills/seo-fundamentals/SKILL.md审计脚本.agents/skills/seo-fundamentals/scripts/seo_checker.pySEO/GEO 专家 Agent 定义.agents/agent/seo-specialist.mdGEO 基础技能AI 搜索引擎优化.agents/skills/geo-fundamentals/SKILL.md站点元数据与 Schema 落地web/src/app/layout.tsxrobots.txt 与 sitemap 生成web/src/app/robots.ts、web/src/app/sitemap.ts文档区元数据覆盖示例web/src/app/docs/layout.tsx【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ag-kit 仓库 SEO 基础技能：E-E-A-T、Core Web Vitals 与可执行的站点审计实践
ag-kit 仓库 SEO 基础技能E-E-A-T、Core Web Vitals 与可执行的站点审计实践【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit本文以 .agents/skills/seo-fundamentals/SKILL.md 为骨架完整解析其 E-E-A-T 框架、Core Web Vitals 指标、技术 SEO 与内容 SEO 原则、Schema 标记、AI 内容指南和排名因素优先级并结合 ag-kit 仓库内真实落地的元数据配置、robots/sitemap 生成逻辑与seo_checker.py审计脚本说明如何把这套原则变成可复制、可验证的工程实践。读完你可以掌握一套从「搜索引擎可见性原理」到「源码级落地检查」的完整 SEO 工作流。1. 技能文档定位这份 SKILL.md 讲什么seo-fundamentals是 ag-kit 仓库.agents/skills/目录下的一个标准技能Skill它的 frontmatter 明确定义了触发时机与使用边界name: seo-fundamentals description: SEO fundamentals, E-E-A-T, Core Web Vitals, and Google algorithm principles. when_to_use: When optimizing web pages for search engines, implementing meta tags, improving E-E-A-T, or fixing Core Web Vitals. allowed-tools: Read, Glob, Grep version: 1.0.0description说明该技能的覆盖面SEO 基础、E-E-A-T、Core Web Vitals 与 Google 算法原则when_to_use明确了调用场景为搜索引擎优化网页、实现 meta 标签、改进 E-E-A-T、修复 Core Web Vitalsallowed-tools限定该技能只读使用 Read / Glob / Grep 三个工具即这是一份「知识型」技能本身不写文件version1.0.0 表明它随仓库版本化管理可被 .agents/skills/ 下的技能编排机制引用。在 ag-kit 的 Agent 体系中该技能被 .agents/agent/seo-specialist.mdSEO/GEO 专家 Agent声明为依赖技能skills: clean-code, seo-fundamentals, geo-fundamentals并在 .agents/skills/geo-fundamentals/SKILL.mdGEO 基础中形成互补SEO 面向传统搜索引擎排名GEO 面向 AI 搜索引擎引用。二者叠加才构成 ag-kit 官方定义的「Content for humans, structured for machines」双目标策略。2. E-E-A-T 框架经验、专业、权威与信任E-E-A-T 是 Google 质量评估指南的核心框架技能文档将四个原则与其对应的信号整理如下原则Principle信号SignalsExperience经验第一手知识、真实案例Expertise专业资质证明、知识深度Authoritativeness权威反向链接、被提及、行业认可Trustworthiness可信HTTPS、透明度、准确信息在仓库中.agents/agent/seo-specialist.md 将这套框架进一步转化为可执行的「如何证明」清单Experience 用真实故事与一手经验体现Expertise 用证书与认证体现Authoritativeness 依赖反链与行业提及Trustworthiness 则落实为 HTTPS、透明度与真实评价。实践要点Experience 与 Expertise 的区别经验强调「你做过」专业强调「你懂且被认证」。二者都要在内容中显性化例如署名作者的实际项目经历 认证信息Trustworthiness 是地基没有 HTTPS、没有准确信息前三个 E-A-T 信号都会大打折扣权威需要外部证据反向链接和行业提及无法靠页面自说自话需要在内容策略中主动经营。3. Core Web Vitals三项核心性能指标Core Web Vitals 是衡量页面用户体验的官方指标集合技能文档给出三项核心指标及「良好」目标阈值指标Metric目标Target衡量内容MeasuresLCP 2.5s加载性能Largest Contentful Paint最大内容绘制INP 200ms交互性Interaction to Next Paint下一次绘制的交互延迟CLS 0.1视觉稳定性Cumulative Layout Shift累计布局偏移.agents/agent/seo-specialist.md 还补充了「好 / 差」的完整阈值边界可用于分级评估指标Good良好Poor较差LCP 2.5s 4.0sINP 200ms 500msCLS 0.1 0.25落地建议LCP主要受首屏最大元素图片、标题块影响预加载 LCP 资源、使用现代图片格式、控制服务器响应时间INP关注交互响应减少主线程长任务、合理拆分 JS、避免大型布局抖动CLS关注视觉稳定性为图片和广告位预留尺寸、避免在已有内容上方插入元素。ag-kit 的 Web 站点在根布局 web/src/app/layout.tsx 中通过viewport配置声明了width: device-width, initialScale: 1并设置双主题themeColor这是保证移动端渲染与视觉稳定性的基础配置同时ThemeProvider使用disableTransitionOnChange避免主题切换引发布局偏移从工程上呼应 CLS 的治理思路。4. 技术 SEO 原则4.1 站点结构可抓取性的四大支柱技能文档将站点结构要素归纳如下要素Element作用PurposeXML sitemap帮助爬虫抓取robots.txt控制爬虫访问Canonical 标签防止重复内容HTTPS安全信号ag-kit 的 Web 站点对以上四项均有源码级落地可直接对照验证1robots.txt—— web/src/app/robots.ts 用 Next.js MetadataRoute 动态生成import type { MetadataRoute } from next; export default function robots(): MetadataRoute.Robots { return { rules: { userAgent: *, allow: / }, sitemap: https://ag-kit.unikorn.vn/sitemap.xml, }; }它向所有爬虫userAgent: *开放全站allow: /并显式声明 sitemap 地址将「控制访问」与「引导抓取」一次配齐。2XML sitemap—— web/src/app/sitemap.ts 动态生成站点地图包含首页、全部文档入口以及 10 个指南示例guide/examples并为每条路由设置抓取频率与优先级const GUIDE_EXAMPLES [ brainstorm, plan, create, new-feature, debugging, test, preview, status, orchestration, deployment, ];每条路由的changeFrequencychangelog 为 weekly其余为 monthly和priority首页 1、文档页 0.9、其余 0.7说明站点地图不是「列出所有 URL」就完事而是用优先级和更新频率帮助搜索引擎理解页面权重层级。3Canonical 标签—— 在 web/src/app/layout.tsx 的 metadata 中声明alternates: { canonical: / }并通过metadataBase将相对路径解析为完整 URL防止因多域名、多参数导致的重复内容问题。4HTTPS—— 作为安全信号与信任信号站点 metadata 中所有 URLmetadataBase、Open Graphurl、sitemap 基地址均使用https://前缀属于 E-E-A-T 中 Trustworthiness 的技术承载。4.2 性能因素因素Factor影响Impact页面速度直接决定 Core Web Vitals移动端友好排名因素之一干净 URL提升可抓取性从源码结构看ag-kit 站点在 web/src/app/layout.tsx 中通过viewport设置 device-width 适配移动端并在构建配置层web/next.config.ts控制打包与静态资源优化同时manifest.ts提供 PWA 配置进一步改善移动端体验。这些都属于「移动端友好 页面速度」的工程侧支撑。5. 内容 SEO 原则5.1 页面元素最佳实践技能文档对每个核心页面元素给出了明确的规范元素Element最佳实践Best PracticeTitle 标签50–60 字符关键词前置Meta description150–160 字符有吸引力H1每页唯一包含主关键词H2–H6逻辑层级清晰Alt 文本描述性不堆砌关键词在 web/src/app/layout.tsx 中可以看到 ag-kit 对 Title 与 description 的工程化处理export const metadata: Metadata { title: { default: AG Kit - AI Agent Capability Expansion Toolkit, template: %s | AG Kit, }, description: A comprehensive collection of 47 skills, 20 specialist agents, rules, and production-ready workflows for modern AI coding assistants.,Title 模板defaulttemplate的组合意味着每个子页面只需提供自己的标题片段最终自动拼接为「页面标题 | AG Kit」既保证关键词前置又保证品牌一致性页面级覆盖例如文档区在 web/src/app/docs/layout.tsx 中覆盖为title: Documentation | AG Kit各文档子页面再进一步细化Alt 文本根布局的 Open Graph 图片/images/og-image.png也配置了描述性 alt与技能文档「描述性而非堆砌」的要求一致。5.2 内容质量因素因素Factor重要性Importance深度Depth全面覆盖主题新鲜度Freshness定期更新独特性Uniqueness提供原始价值可读性Readability清晰表达结合 .agents/agent/seo-specialist.md 的内容 SEO 检查清单可将这四个因素转为落地动作Title 优化至 50–60 字符、Meta description 控制在 150–160 字符、H1–H6 层级正确、内部链接结构完整、图片 alt 齐全——检查清单让「质量」变成可勾选、可审计的条目。6. Schema 标记类型让机器理解结构技能文档列出七类常用 Schema 标记及其适用场景类型Type用途UseArticle博客文章、新闻Organization公司信息Person作者档案FAQPage问答内容Product电商产品Review评分评价BreadcrumbList导航面包屑ag-kit 站点在 web/src/app/layout.tsx 中通过application/ldjson注入了完整的 JSON-LD 结构化数据直接展示了两类 Schema 的真实写法const jsonLd { context: https://schema.org, graph: [ { type: WebSite, id: https://ag-kit.unikorn.vn/#website, url: https://ag-kit.unikorn.vn/, name: AG Kit, description: Antigravity-first AI agent engineering kit ..., inLanguage: en-US }, { type: SoftwareApplication, id: https://ag-kit.unikorn.vn/#software, name: AG Kit, applicationCategory: DeveloperApplication, operatingSystem: Cross-platform, offers: { type: Offer, price: 0, priceCurrency: USD }, softwareVersion: 2026.8.31, author: { type: Organization, name: AG Kit Team } } ] };要点解读使用graph将多个实体WebSite SoftwareApplication组织在同一份 JSON-LD 中减少重复声明id提供实体标识帮助搜索引擎做实体关联entity consolidationSoftwareApplication 声明了applicationCategory、offers价格为 0 的开源项目、softwareVersion等结构化字段属于与技能文档「Article / Organization / Product」等类型呼应的实际案例。7. AI 内容指南Google 认可的内容生产方式技能文档用「该做/不该做」对照表给出了 AI 时代的内容准则✅ 该做Do❌ 不该做DontAI 起草 人工编辑直接发布原始 AI 内容加入原创洞见无价值地复制专家审阅跳过事实核查遵循 E-E-A-T关键词堆砌这与仓库中 GEO 技能的判断一致AI 引擎会优先引用「清晰、权威、易于抽取」的内容。落到工程层面可以将此准则与 .agents/agent/seo-specialist.md 的 GEO 检查清单配合使用——FAQ 段落、作者资质可见、带来源的统计数据、清晰定义、署名专家引言、「Last updated」时间戳——这些元素恰好也是人类读者信任感的来源实现「内容为人、结构为机」的统一。8. 排名因素优先级技能文档给出了一份按优先级排序的排名因素清单优先级Priority因素Factor1高质量、相关性强的内容2来自权威站点的反向链接3页面体验Core Web Vitals4移动端优化5技术 SEO 基础这份排序说明内容质量是第一位技术手段性能、移动端、robots/sitemap/canonical是排在其后的基础保障而反向链接则是内容价值的外部放大器。这也解释了为什么技能文档把大量篇幅放在内容与 E-E-A-T 上而将 robots.txt、sitemap 等技术项定位为「基础」fundamentals。9. 度量用数据验证 SEO 效果指标Metric工具Tool排名RankingsSearch Console、Ahrefs流量TrafficAnalyticsCore Web VitalsPageSpeed Insights索引状态IndexingSearch Console反向链接BacklinksAhrefs、Semrush实践顺序建议先在 Search Console 确认页面被正确索引 → 用 PageSpeed Insights 验证 Core Web Vitals 达标 → 用 Analytics 跟踪流量 → 用 Ahrefs/Semrush 观察排名与反链变化形成「索引 → 性能 → 流量 → 排名」的闭环验证。10. 仓库内落地seo_checker.py 一键审计技能文档还挂载了一个配套脚本 .agents/skills/seo-fundamentals/scripts/seo_checker.py把前文的原则变成了可执行的自动化审计。运行方式python .agents/skills/seo-fundamentals/scripts/seo_checker.py project_path该脚本Python 3无第三方依赖的核心设计如下1页面识别find_pagesis_page_file扫描**/*.html、**/*.htm、**/*.jsx、**/*.tsx跳过node_modules、.next、dist、build、test等目录只有位于pages/app/routes/views/screens目录、或文件名含page/index/home/about/contact等特征的文件才被视为公开页面最多审计 50 个文件。2六项检查check_pageTitle 标签页面缺少title或布局中无title/Head时告警Meta description缺少namedescription时告警Open Graph 标签缺少og:社交分享标记时告警H1 层级同一页面出现多个h1时告警对应「每页唯一 H1」原则图片 Alt图片无alt属性或alt空值时告警对应「描述性 alt」原则脚本中has_title/has_description/has_og三项只在is_layout检测到Head或head的布局/模板文件时才算问题避免对子页面重复告警——从源码结构看这是对 Next.js「layout 管 meta、page 管内容」架构的适配。3汇总输出按问题类型统计数量Issue Summary、列出受影响文件并输出结构化 JSON 结果{ script: seo_checker, project: /path/to/project, files_checked: 12, files_with_issues: 3, issues_found: 5, passed: false }passed为false时进程以退出码 1 结束因此可以直接接入 CI/本地校验流程。与之配套的 .agents/skills/geo-fundamentals/scripts/geo_checker.py 则专注于 AI 引用就绪度它只识别真正的公开路由入口Next.js App Router 下仅app目录中的page.tsx视为路由检查结构化数据、作者信息、日期、FAQ 段落等 GEO 要素两脚本构成「SEO 基础审计 GEO 引用就绪审计」的完整防线。11. 结语SEO 是一场长期游戏技能文档的收尾给出了整份文档的方法论总结SEO is a long-term game. Quality content technical excellence patience results.将这句话翻译成工程行动就是本文的完整闭环内容侧以 E-E-A-T 四原则组织内容遵循 Title/Meta/H1/Alt 规范按优先级清单分配投入技术侧配置 robots.txt 与 XML sitemap、声明 canonical 与 HTTPS、控制 Core Web Vitals 三项指标机器侧用 JSON-LD Schema 让实体可被理解同时兼顾 AI 引擎的 GEO 引用需求验证侧用仓库自带的seo_checker.py持续审计用 Search Console / PageSpeed Insights 度量效果迭代优化。这套「原理文档 源码落地 自动化审计脚本」的组合正是 ag-kit 把 SEO 从方法论变成可维护工程的最佳注脚。延伸阅读仓库内相关资源技能本体.agents/skills/seo-fundamentals/SKILL.md审计脚本.agents/skills/seo-fundamentals/scripts/seo_checker.pySEO/GEO 专家 Agent 定义.agents/agent/seo-specialist.mdGEO 基础技能AI 搜索引擎优化.agents/skills/geo-fundamentals/SKILL.md站点元数据与 Schema 落地web/src/app/layout.tsxrobots.txt 与 sitemap 生成web/src/app/robots.ts、web/src/app/sitemap.ts文档区元数据覆盖示例web/src/app/docs/layout.tsx【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考