seo

顶层 SEO/GEO 2026 编排器，通过 `/seo $1 $2` 调用（$1 = 命令，$2 = URL 或本地路径）。负责路由到 20 个子技能，涵盖全站审计（seo-audit）、单页分析（seo-page）、技术 SEO、Schema 标记、内容质量（E-E-A-T）、AI 搜索 / GEO 优化（AI Overviews 准备度）、本地 SEO、站点地图 / robots、内链、语义聚类、内容简报、按业务类型制定战略规划、搜索体验（SXO）、精选摘要、实体 / 语义 SEO、电子商务、视频、hreflang/i18n，以及重定向 / 迁移 — 完整的命令到子技能映射请参阅正文中的快速参考命令表。以本地优先（零第三方 API、零 Google API、零 Python — 仅使用 TS/Bun 脚本）；将特定框架的实现委派给 fuse-astro/fuse-nextjs/fuse-laravel。还负责每个项目首次调用时的 `.fuse-seo` 自选激活钩子，以及在 `.fuse-seo/reports/` 下生成分析后报告。

SEO/GEO 编排器

调用方式： /seo $1 $2，其中 $1 是命令，$2 是 URL 或本地路径。

面向所有行业（SaaS、本地服务、电子商务、出版商、代理机构）的综合 SEO + GEO 2026 分析。编排 20 个子技能和 8 个并行子 Agent。本地优先，零第三方 API。

快速参考

命令	功能	子技能
/seo audit <url>	通过并行子 Agent 委派执行完整审计	seo-audit
/seo page <url|path>	深入分析单个页面	seo-page
/seo technical <url>	技术 SEO（robots、CWV、可抓取性）	seo-technical
/seo schema <url|path>	检测/验证/生成 JSON-LD	seo-schema
/seo content <url>	E-E-A-T + 防内容蚕食	seo-content
/seo images <url>	图片 SEO：替代文本、格式、延迟加载	seo-images
/seo sitemap <url|generate>	分析或生成 XML 站点地图	seo-sitemap
/seo hreflang <url>	i18n/多语言审计与生成	seo-hreflang
/seo internal-linking <url>	支柱/主题集群、锚文本优化	seo-internal-linking
/seo cluster <keyword>	基于 SERP 的语义聚类	seo-cluster
/seo brief <topic>	生成详细内容简报	seo-content-brief
/seo plan <type>	战略规划（SaaS/本地/电子商务/出版商）	seo-plan
/seo sxo <url>	搜索体验优化	seo-sxo
/seo snippets <url>	零号位置 + AI Overviews 输入	seo-featured-snippets
/seo local <url>	本地 SEO（GBP、NAP、引文、地图包）	seo-local
/seo geo <url>	AI Overviews/ChatGPT/Perplexity/Claude 准备度	seo-geo
/seo entity <url>	实体/语义 SEO、知识图谱、显著性	seo-entity
/seo ecommerce <url>	产品 Schema、多面导航、市场平台	seo-ecommerce
/seo video <url>	VideoObject、YouTube、文字稿	seo-video
/seo redirects <url>	301/302、迁移、重定向链	seo-redirects
/seo drift <url>	与之前的 git HEAD 进行 SEO 差异比较	（使用 diff-seo.ts）

编排逻辑 — /seo audit

用户调用 /seo audit <url> 时：

1. 从首页识别业务类型（SaaS、本地、电子商务、出版商、代理机构）
2. 并行启动子 Agent（在单条消息中发起多个 Agent 调用）：
   • seo-technical（robots、站点地图、CWV、hreflang）
   • seo-schema（JSON-LD 检测/验证）
   • seo-content（E-E-A-T、防内容蚕食）
   • seo-geo（AI Overviews 准备度）
   • seo-entity（知识图谱、显著性、sameAs/knowsAbout）
   • seo-images（替代文本、格式、优化）
   • seo-sitemap（sitemap.xml + robots.txt）
3. 如果检测到本地业务 → 还启动 seo-local
4. 如果存在内容策略信号（博客、支柱页面）→ 还启动 seo-cluster
5. 收集结果，生成统一报告，并给出 SEO 健康评分（0-100）
6. 制定按优先级排序的行动计划（严重 → 高 → 中 → 低）

工作流（7 个阶段 — 适用于内容创作流程）

PHASE 1: ANALYZE   → Extract content, detect intent
PHASE 2: RESEARCH  → SERP analysis, 2026 trends, AI platforms
PHASE 3: KEYWORDS  → Extract with anti-cannibalization
PHASE 4: STRUCTURE → Meta, OG, Twitter Cards, Hn, schema, alt
PHASE 5: CONTENT   → Write SEO+GEO optimized content
PHASE 6: VALIDATE  → SEO + GEO compliance checklists
PHASE 7: DRIFT     → Compare to git HEAD (diff-seo.ts)

参考库（旧版 10 个类别）

references/
├── 01-seo-foundations/   → research workflow, SEO vs GEO
├── 02-onpage-seo/        → meta tags, OG, Twitter, headers, alt
├── 03-schema-org/        → 9 schema types (templates ready)
├── 04-geo-2026/          → AI platforms, citations, zero-click
├── 05-technical-seo/     → CWV, mobile-first, crawlability
├── 06-content-strategy/  → E-E-A-T, anti-cannibalization, keywords
├── 07-sea-google-ads/    → Quality Score, landing pages (optional)
├── 08-measurement/       → GEO tracking, Share of Model
├── 09-checklists/        → pre-publication, technical audit
└── 10-local-seo/         → GBP, NAP, citations, Local Pack

可用脚本（scripts/）

脚本	用途
parse-meta.ts	通过 cheerio 提取标题／描述／OG／canonical
validate-schema.ts	使用 schema.org 转储文件离线验证 JSON-LD
check-cwv.ts	Lighthouse CLI 本地封装
parse-sitemap.ts	验证 sitemap.xml 结构
parse-robots.ts	验证 robots.txt 指令
parse-hreflang.ts	验证 hreflang 标签
diff-seo.ts	通过 git diff 检测 SEO 变化
geo-score.ts	LLM 就绪度评分（0-100）
analyze-keywords.ts	内容智能分析：密度、n 元语法、0-100 关键词堆砌评分、本地分布（本地优先）

差异化优势

• 本地优先：不调用 Google API、DataForSEO/Moz，也不使用 Python
• 框架原生：将实现工作交由 fuse-astro、fuse-nextjs、fuse-laravel
• GEO 优先：以 AI Overviews/ChatGPT/Perplexity 为主要目标，而非事后考虑
• TS/Bun 技术栈：所有脚本均使用 TypeScript 编写，并通过 Bun 执行

行业检测

根据首页信号检测：

• SaaS：/pricing、/features、/integrations、“免费试用”、“注册”
• 本地业务：地址、电话、营业时间、GBP 链接、NAP
• 电子商务：/products、/cart、/checkout、产品 schema
• 出版商：/articles、NewsArticle schema、署名、日期
• 代理机构：/services、/case-studies、/clients、客户评价

质量门槛

• 30+ 个地点页面 → 警告
• 50+ 个地点页面 → 强制停止，要求人工审核
• 100+ 个程序化页面 → 警告
• 500+ 个程序化页面 → 强制停止
• 按页面类型检测内容单薄
• 防止创建门页

首次调用 — 激活钩子

当用户首次在项目中调用 /seo 时：

1. 检查项目根目录（或直至仓库根目录的任意父目录）中是否存在 .fuse-seo 标记文件
2. 如果不存在，则在进行任何其他工作之前询问用户：

   “要在此项目中激活 fuse-seo 钩子吗？激活后，每次通过 @fusengine/harness 的 seo 作用域对类似 HTML 的文件（.html、.astro、.tsx、.vue、.blade.php）执行 Write/Edit 时，都会验证 meta/schema/OG。”

3. 如果用户确认 → 通过 touch .fuse-seo（或使用内容为空的 Write 工具）在项目根目录创建空文件 .fuse-seo
4. 如果用户拒绝 → 继续操作，但不创建标记文件（钩子在此项目中保持休眠）
5. 同一会话中不要再次询问 — 标记文件是否存在就是持久保存的答复

此功能按设计采用选择加入机制：未经用户明确同意，绝不自动创建。

完成任何分析后

1. 在 .fuse-seo/reports/<date>-<command>.md 中生成 Markdown 报告
2. 提供保存变化基线的选项：使用 /seo drift <url> 以便日后比较
3. 建议通过委派方式进行特定框架的实现：
   • Astro 项目 → fuse-astro:astro-seo
   • Next.js → fuse-nextjs:nextjs-stack
   • Laravel → fuse-laravel:laravel-blade