1. 项目概述当AI助手成为你的全职SEO专家如果你是一名开发者或者运营着一个技术驱动的网站那么“SEO优化”这个词对你来说大概率意味着两件事一是知道它很重要二是觉得它很麻烦。麻烦在哪它不是写几行代码就能解决的单一问题而是一个涉及技术、内容、结构、数据的系统工程。你需要处理robots.txt、sitemap.xml要写对搜索引擎和AI都友好的JSON-LD结构化数据要分析关键词要规划内容还要时刻提防网上那些早已过时甚至有害的“SEO秘籍”。整个过程琐碎、重复且极度依赖经验。seo-geo-optimizer的出现就是为了把开发者从这种重复性劳动中彻底解放出来。它不是一个需要你手动运行、逐项配置的传统工具而是一个“AI技能”AI Skill。你可以把它理解为你IDE集成开发环境里AI助手比如Cursor的AI、GitHub Copilot、Windsurf的Cascade等的一个“专家级外挂”。安装了这个技能后你的AI助手就不再是一个普通的代码补全工具它会摇身一变成为一名拥有严格SOP标准作业程序的SEO与GEO生成式引擎优化专家。这个技能的核心逻辑非常“程序员友好”先问清楚再全自动执行。它不会让你在模糊的指令和来回的对话中摸索而是在启动时通过一组精心设计的40个问题一次性收集你网站的全部背景信息。之后它便会基于一套不可违背的“16条铁律”Iron Laws自动执行14个阶段的优化流程从网站智能分析、竞争对手调研到技术SEO实施、结构化数据生成再到内容策略制定与GEO优化最终输出一整套可直接部署或参考的文件。整个过程你只需要在开始时回答那40个问题之后就可以泡杯咖啡看着AI助手在你项目的文件系统中像一位不知疲倦的资深顾问一样生成所有必要的交付物。2. 核心设计理念为什么是“AI技能”而非传统工具在深入使用之前理解seo-geo-optimizer的设计哲学至关重要。这决定了它的使用方式和能带来的价值上限。2.1 从“工具”到“专家系统”的范式转移传统的SEO工具无论是线上平台还是命令行工具本质上是“功能集合”。你需要自己决定先做什么、后做什么需要理解每个功能输出的含义并手动将结果应用到你的项目中。这个过程存在认知断层工具输出报告但将报告转化为行动依然需要你或你的团队的专业知识。seo-geo-optimizer则实现了范式转移。它将自己定义为“技能”直接嵌入到你的AI助手中。这意味着它利用的是AI助手的推理能力和上下文理解能力。技能文件SEO_GEO_SKILL.md本质上是一份极其详尽的“工作说明书”和“质量控制手册”。AI助手在激活该技能后会严格按照说明书的要求进行思考、提问和执行。这样做有几个决定性优势上下文感知AI助手在你的项目环境中运行它能直接“看到”你的代码结构、文件组织甚至能读取现有配置文件。这使得它的优化建议和生成的文件能完美契合你的技术栈如Next.js, React, Vue等。过程自动化14个阶段的执行是连贯的、有依赖关系的。AI助手会确保前一阶段验证无误后才进入下一阶段避免了人工操作可能出现的步骤跳跃或遗漏。质量强制保障“16条铁律”是硬编码的规则。例如它强制要求生成的robots.txt必须允许GPTBot、PerplexityBot等AI爬虫强制要求所有JSON数据必须通过验证强制要求每个页面必须以一个40-60词的“直接回答区块”开头。这些规则不是建议是AI助手必须遵守的“法律”从程序层面杜绝了低质量输出。2.2 GEO为生成式AI搜索时代而设计传统的SEO搜索引擎优化主要针对Google、Bing这类传统搜索引擎的爬虫和排名算法。但如今流量来源正在多元化ChatGPT、Perplexity、Claude以及各类AI搜索聚合工具统称为LLM搜索引擎或生成式引擎的比重日益增加。这些引擎的工作原理与传统爬虫有显著不同它们更依赖高质量、结构化、事实密集的内容来生成答案。seo-geo-optimizer中的“GEO”Generative Engine Optimization部分正是为此而生。它不仅仅是增加几个meta标签而是一套完整的优化策略llms.txt文件类比于robots.txt但它是专门给AI爬虫看的“上下文文件”用于声明网站内容如何被AI理解和引用。内容格式化强制要求内容以“答案优先”的方式组织并保证每200字至少包含一个可引用的数据或统计这直接迎合了LLM生成权威答案的需求。实体解析Entity Resolution通过强大的Organizationschema和sameAs属性在互联网上明确“你是谁”帮助AI准确地将你的品牌与知识图谱中的实体关联起来。这个设计让优化工作不再只盯着Google的算法更新而是前瞻性地布局全渠道的可见性包括正在崛起的AI原生搜索场景。2.3 对“SEO神话”的免疫系统SEO领域充斥着大量过时或错误的信息比如“必须严格遵循H1-H6层级”、“要疯狂降低跳出率”、“低权威外链必须全部拒绝”等等。新手甚至很多从业者都会在这些“神话”上浪费大量时间。seo-geo-optimizer内置了一个“反模式保护”列表。在它的“16条铁律”中明确有一条LAW_14规定永不推荐、实施或验证基于已被证伪的神话。技能文件里甚至直接列出了10个它绝不会执行的常见错误建议。这意味着通过这个技能获得的优化方案是建立在当前技能编写时被广泛认可的SEO最佳实践之上的帮你自动避开了无数坑。3. 实战部署在不同IDE中安装与激活技能理论很美好但第一步是把它用起来。seo-geo-optimizer提供了极其便捷的安装方式几乎覆盖了所有主流的AI增强型IDE。3.1 一键安装推荐最省心的方式就是在你的项目根目录打开终端运行npx seo-geo-optimizer这个命令会执行一个智能安装脚本bin/install.js。它会自动检测你当前使用的IDE类型并将技能文件下载到该IDE对应的正确目录中。例如如果你在Cursor中打开的项目里运行它会自动创建.cursor/rules/seo-geo-optimizer.mdc文件并填入技能内容。完成后你只需要在AI聊天框里输入Start seo-geo-optimizer对话就开始了。3.2 手动安装指南如果你倾向于手动控制或者你的IDE不在自动检测列表里手动安装是万能方法。核心步骤永远是两步获取技能文件内容访问项目的GitHub仓库复制skill/SEO_GEO_SKILL.md文件的全部内容。放置到IDE的指令目录在你的项目根目录下创建对应的文件并粘贴内容。下面是一些常见IDE的具体路径IDE手动安装路径说明Cursor.cursor/rules/seo-geo-optimizer.mdcCursor的规则文件激活后对所有会话生效。Windsurf.windsurf/rules/seo-geo-optimizer.mdWindsurf的规则文件用于Cascade AI会话。GitHub Copilot (VSCode).github/copilot-instructions.mdCopilot的全局项目级指令文件。Bolt.new.bolt/promptBolt项目的AI提示词文件。Claude CodeCLAUDE.md项目根目录下的Claude专用指令文件。Replit系统提示词框Replit没有持久化文件需在AI助手的系统提示词中粘贴。Antigravity~/.gemini/GEMINI.md这是全局安装一次安装在所有项目生效。实操心得文件路径是关键我最初在Cursor里手动安装时曾错误地将文件放在了.cursor/rules/目录下但文件名用了.md后缀。结果技能没有生效。后来检查文档才发现Cursor的规则文件推荐使用.mdc后缀。虽然.md也可能工作但为了确保兼容性最好严格遵循推荐的命名。这个小细节也体现了这类工具对配置的精确性要求。3.3 启动与首次对话安装完成后在你IDE的AI聊天窗口中输入启动指令例如Start seo-geo-optimizer或开始SEO优化具体看技能文件的引导AI助手就会加载该技能。紧接着你就会进入Phase 0 – 信息收集阶段。AI助手会开始连续提出那40个问题。这些问题被分为5组逻辑非常清晰A组-站点身份基础信息如URL、品牌名、业务描述。B组-业务与目标你的商业模式、目标受众、核心关键词、竞争对手。C组-当前SEO状态现有技术设施Schema、站点地图等、流量情况。D组-内容与链接内容策略、发布频率、社交媒体和外链情况。E组-品牌与AI存在知识面板、权威信号、独家数据、成功指标。注意事项如何高效回答这40个问题提前准备在启动技能前最好花10分钟把这些问题过一遍将答案整理在一个文档里。特别是竞争对手URL、目标关键词、业务核心数据这些信息临时想可能不准确。保持具体回答越具体AI生成的方案越精准。例如对于“目标受众”不要只说“开发者”可以说“拥有2-5年经验、主要使用React和Next.js技术栈的前端开发者”。诚实告知对于“是否受过Google惩罚”、“现有流量”等问题如实回答。AI需要基于真实情况制定策略隐瞒或夸大没有意义。利用上下文如果你的项目代码中已经包含了一些信息比如package.json里的项目描述AI助手有时能直接读取并预填答案你可以直接确认或修改。4. 14阶段自动化执行流程深度解析回答完40个问题后AI助手就会进入全自动执行模式。这14个阶段并非孤立任务而是一个环环相扣的流水线。理解每个阶段的产出和目的能让你更好地评估和利用最终结果。4.1 阶段1-3分析与规划战略层阶段1站点智能报告生成site_intelligence_report.md。这份报告是基于你的回答对网站现状的快速诊断会指出明显的优势、短板和机会点。这是所有后续工作的基石。阶段2竞争对手分析生成competitor_analysis.md。AI会访问你提供的竞争对手URL分析他们的标题策略、关键词布局、内容结构、技术实现等找出可借鉴和可超越的点。阶段3执行计划生成execution_plan.md。这是前两个阶段的综合产出是一份具体的行动路线图。它会明确优先级告诉你应该先修复哪个技术问题先创作哪篇核心内容。为什么这三个阶段不可或缺很多开发者喜欢跳过分析直接动手但“方向错了努力白费”。这三个文档确保了优化动作不是盲目的而是有数据、有对比、有策略的。即使你时间紧迫也至少应该仔细阅读《执行计划》。4.2 阶段4-8核心策略与架构战术层阶段4内容策略产出keyword_clusters.json和一系列content_brief_{slug}.md文件。keyword_clusters.json是基于你的核心主题通过语义关联生成的关键词簇用于指导内容金字塔Pillar-Cluster模型的构建。每个content_brief则是一篇具体文章的内容大纲包含了目标关键词、标题建议、H2问题列表、参考资料建议等。这是内容创作的“施工图”。阶段5技术SEO生成或更新robots.txt、sitemap.xml、meta_tags.json和cwv_precheck.md。这里有几个关键点robots.txt会确保允许主流的AI爬虫。sitemap.xml会根据你提供的页面信息动态生成。meta_tags.json是一个配置文件为后续阶段批量注入Meta标签提供数据。cwv_precheck.md是一份核心Web指标LCP, FID, CLS的优化检查清单虽然AI不能直接优化代码但会给出具体的、针对你技术栈的建议。阶段6Schema与结构化数据生成organization_schema.json全站通用和每个页面对应的{slug}_schema.json。AI会尝试根据页面内容自动判断适用的Schema类型如Article, Product, FAQ等并生成符合规范的JSON-LD代码。这是提升搜索摘要丰富度Rich Results和帮助AI理解内容的关键。阶段7GEO优化生成llms.txt和geo_tracking.json。llms.txt是GEO的核心它可能包含网站的描述、内容类型、事实核查声明等供AI爬虫参考。geo_tracking.json则用于记录和追踪内容在AI引擎中的表现。阶段8内部链接架构生成internal_link_audit.json。AI会分析你计划中或现有的所有页面构建一个内部链接图识别出“孤儿页面”没有任何内链指向的页面并建议合理的内部链接锚文本以传递权重和改善爬行效率。4.3 阶段9-14内容生成与交付执行与收尾层阶段9内容生成在content/目录下根据阶段4的简报生成完整的、优化后的文章Markdown文件{slug}.md。这些内容会严格遵守“铁律”以直接回答开头、H2以问题形式呈现、事实密度达标。阶段10页面SEO优化将阶段5准备的meta_tags.json中的标题、描述、OG标签等注入到对应的页面文件HTML或框架的Head组件中。对于静态站点生成器如Next.js, Gatsby它会生成或修改对应的React组件或配置文件。阶段11GEO引用设置基于生成的内容初始化geo_tracking.json文件为后续监控AI引用情况建立基线。阶段12最终验证报告生成final_verification_report.md。这份报告会逐一核对“16条铁律”的遵守情况并给出一个通过/失败清单确保所有产出物质量达标。阶段13维护计划生成maintenance_schedule.md。SEO不是一劳永逸的这份计划会建议内容更新频率、技术检查周期、排名监控重点等。阶段14交付物摘要生成README_DELIVERABLES.md。这是一份给项目维护者的总览文档解释了每个生成文件的用途、位置和下一步操作。避坑技巧分阶段审查与集成不要等到14个阶段全部跑完才去看结果。我建议的策略是在阶段5技术SEO完成后立即检查生成的robots.txt和sitemap.xml确保它们符合你的服务器配置比如Allow/Disallow规则。在阶段6Schema完成后将生成的JSON-LD代码用Google的 Rich Results Test 工具测试一下确保没有错误。在阶段9内容生成完成后快速浏览生成的文章虽然AI写作质量很高但涉及专业领域时仍需人工复核关键数据和观点。将AI生成的文件如meta_tags.json、Schema文件与你项目的构建流程如Webpack、Vite或CMS系统进行集成可能需要写一些简单的脚本或修改配置。5. “16条铁律”详解质量控制的基石“16条铁律”是seo-geo-optimizer区别于其他任何自动化工具的灵魂。它们不是建议而是AI在执行时必须通过的强制性检查点。理解这些铁律你就能理解这个技能输出的质量为何有保障。下面我挑选几条最具代表性、也最能体现其设计深度的铁律进行拆解LAW_4: 每个生成的文件都必须写入磁盘这意味着AI助手不能仅仅在聊天窗口里输出代码或文本。它必须通过fs.writeFileSync或等效操作在你的项目目录中创建实实在在的文件。这保证了交付物的可追溯、可版本管理以及真正的“开箱即用”。LAW_8 LAW_9: 内容格式的强制标准LAW_8每个页面必须以40-60词的“直接回答区块”开头。这模拟了Google的“精选摘要”和AI搜索的“直接答案”格式在信息碎片化时代第一时间抓住用户和AI的注意力。LAW_9每200字至少包含一个被引用的统计或事实。这强制提升了内容的信噪比和权威性使其更有可能被AI引擎和权威网站引用是E-E-A-T经验、专业、权威、可信原则的实操体现。LAW_11: 必须允许AI爬虫生成的robots.txt必须包含对GPTBot(OpenAI),PerplexityBot,ClaudeBot等主流AI爬虫的Allow规则。这是一个非常前瞻性的设计。许多传统SEO建议可能会忽略或禁止这些爬虫但这等于主动放弃了在AI搜索中的可见性。这条铁律确保了你的内容对未来的流量渠道是开放的。LAW_12: 杜绝孤儿页面没有任何内部链接指向的页面对用户和爬虫都难以发现价值极低。AI会检查整个站点的链接图确保每个页面至少有一个内链入口。这不仅仅是SEO最佳实践更是良好的用户体验设计。LAW_14: 免疫SEO神话这是技能的“安全护栏”。当你的指令或对话无意中涉及那10个被列出的神话如“帮我优化跳出率以提升排名”时AI会明确拒绝执行并解释原因。这防止了你在错误的方向上浪费资源。LAW_15 LAW_16: 面向AI的优化与结果固化LAW_15llms.txt必须生成在网站根目录并可访问。这是GEO的“门户文件”。LAW_16所有内容必须写入文件而非打印到聊天框。这再次强调了“交付物驱动”的工作流确保每一次执行都有切实的产出。实操心得利用铁律进行代码审查你可以把这些铁律当作一份高质量的“SEO代码审查清单”。即使不通过这个技能在手动进行SEO优化时对照这份清单尤其是LAW_7关于URL和日期的格式、LAW_10关于组织Schema、LAW_13关于标题格式也能极大地提升你工作的规范性和质量。6. 常见问题与排查技巧实录在实际使用中你可能会遇到一些情况。以下是我在多次使用和测试中总结出的常见问题及解决方法。6.1 安装与启动问题Q1: 运行npx seo-geo-optimizer后没有任何反应或者报错。可能原因A: 网络问题无法从npm或GitHub下载包。排查: 检查网络连接尝试ping registry.npmjs.org。可以尝试使用npx seo-geo-optimizer --verbose如果支持查看详细日志。解决: 切换到稳定的网络环境或使用手动安装方式。可能原因B: Node.js版本过低或不兼容。排查: 运行node -v确保版本在14或以上推荐16。解决: 升级Node.js版本。可能原因C: 项目目录权限不足无法创建隐藏文件夹如.cursor。排查: 尝试在用户目录或桌面新建一个测试项目在其中运行命令。解决: 确保你对当前项目目录有读写权限。Q2: 技能文件已放置但在AI聊天中输入启动指令无反应。可能原因A: 文件路径或名称错误。排查: 严格按照上文“手动安装指南”中的路径和文件名检查。注意Cursor是.mdcWindsurf是.md。解决: 修正路径和文件名。可能原因B: IDE需要重启或刷新AI上下文。排查: 完全关闭IDE再重新打开或者尝试新建一个聊天会话。解决: 重启IDE或新建会话。可能原因C: AI助手未正确加载项目根目录的规则。排查: 在某些IDE中可能需要显式地“激活”或“选择”项目级别的规则集。解决: 查阅你所用IDE的官方文档确认项目级AI指令的加载机制。6.2 执行过程中的问题Q3: AI助手在执行某个阶段如生成sitemap时卡住或报错。可能原因A: 阶段依赖的前置信息不足或矛盾。排查: 回顾你在Phase 0的回答。例如如果网站URL填写错误后续所有基于URL的操作都会失败。解决: 终止当前会话仔细检查并重新回答Phase 0的问题然后重新开始。确保信息准确一致。可能原因B: AI助手的上下文长度或权限限制。排查: 生成长篇内容或操作大量文件时可能触及AI模型的token限制或IDE的安全沙箱限制。解决: 对于大型站点可以尝试分批次优化。先针对核心的少数几个页面运行技能。或者检查IDE设置是否对文件写入有特殊限制。Q4: 生成的内容如文章质量不符合我的预期过于泛泛或有些细节不准确。可能原因A: Phase 0的回答不够具体和深入。排查: AI的产出质量直接取决于输入信息的质量。如果你的业务描述、目标受众、核心优势等信息很模糊AI生成的内容自然也难以精准。解决: 这是最关键的一步。花时间完善那40个问题的答案。提供具体的案例、数据、独特的销售主张USP。你给AI的“弹药”越精良它的“输出”威力越大。可能原因B: 领域过于专业或小众通用AI模型知识储备不足。排查: 生成的内容在基础框架上没问题但涉及深度专业知识时出现偏差。解决: 将seo-geo-optimizer视为一个强大的“初稿生成器”和“结构优化器”。生成后由领域专家进行内容审校和深化这依然比从零开始撰写要高效得多。Q5: 如何将AI生成的文件如Schema JSON集成到我的Next.js/React项目中解决: 这需要一些手动步骤但模式固定对于JSON-LD Schema: 在Next.js中你可以使用next/script组件将生成的{slug}_schema.json内容以application/ldjson类型插入到页面的head中。也可以使用react-helmet或专门的库如next-seo。对于Meta Tags: 将meta_tags.json中的数据映射到你页面组件的Head组件或next/head中。可以编写一个辅助函数来读取这个JSON文件并生成对应的meta元素。对于llms.txt和robots.txt: 将它们放在Next.js项目的public目录下即可通过https://yourdomain.com/llms.txt访问。自动化脚本: 对于经常运行此技能的项目可以写一个简单的Node.js脚本在AI生成文件后自动将其内容复制或合并到项目对应的源码位置。6.3 技能维护与自定义Q6: 我想修改技能的行为比如增加一个自定义的检查项或者调整内容生成的模板该怎么办解决:seo-geo-optimizer的技能逻辑完全定义在skill/SEO_GEO_SKILL.md这个Markdown文件中。你可以fork这个仓库直接修改这个文件。增加阶段: 在“14-Phase Auto-Execution”部分定义新的阶段并在“16条铁律”中补充相应的质量规则。修改问题: 在“The 40 Intake Questions”部分调整问题。调整输出模板: 在技能文件的相应部分通常以“生成格式如下”等提示引导修改AI生成文件的内容结构和格式要求。重要提示: 修改后务必在你的本地项目中测试确保新的技能文件能按预期工作。你也可以向原仓库提交Pull Request贡献你的改进。Q7: 这个技能生成的方案能保证我的网站排名第一吗明确回答:绝对不能保证。没有任何一个工具或技能可以保证搜索排名。搜索引擎排名是数百万个网站、数千个信号动态竞争的结果。正确预期:seo-geo-optimizer的价值在于它能以极高的效率和一致性帮你完成一个专业SEO团队会做的绝大部分基础性和结构性工作并确保这些工作符合当前的最佳实践同时规避常见错误。它为你打下了坚实、正确的地基。但在此之上的“建筑”持续的高质量内容建设、高质量外链获取、品牌影响力提升等依然需要你持续投入。这个技能让你能把宝贵的时间从“铺地基”的重复劳动中节省出来投入到更具创造性的“上层建筑”工作中。从我个人的使用体验来看seo-geo-optimizer最大的价值在于它的“系统性”和“纪律性”。它强迫你在一开始就进行全面的思考40个问题然后以工业化的精度执行一套完整的优化流程。对于独立开发者、小团队或者那些将SEO视为“必要之恶”的技术人员来说它极大地降低了专业门槛并确保了工作质量的下限非常高。它可能不是魔法棒但绝对是一台高效、可靠的“SEO自动化流水线”。