Claude SEO架构深度剖析揭秘3层设计与子技能自动发现机制【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 25 sub-skills 18 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, semantic clustering, e-commerce SEO, international SEO, Google APIs, and PDF/Excel reporting. Optional DataForSEO, Firecrawl, and Banana extensions.项目地址: https://gitcode.com/gh_mirrors/cl/claude-seoClaude SEO 是面向 Claude Code 的开源 SEO 分析技能插件由 1 个主技能orchestrator、25 个子技能sub-skills和 18 个子代理sub-agents协同工作覆盖技术 SEO、内容质量、Schema、GEO/AEO、本地 SEO 等 8 大领域。它能并行派发最多 15 个专家代理几分钟内完成整站审计。很多用户装完就用了却不清楚背后为什么是3 层结构、新子技能又是怎么被自动发现的。这篇文章用尽量少的术语把这两个核心机制讲透。一张图看懂 Claude SEO 的 3 层架构Claude SEO 遵循 Agent Skills 开放标准采用3 层架构directive → orchestration → execution即指令层 → 编排层 → 执行层。官方架构文档在 docs/ARCHITECTURE.md项目总览见 CLAUDE.md。层角色核心目录回答的问题① 指令层 directive项目级说明与全局规则CLAUDE.md、AGENTS.md整个项目怎么运作② 编排层 orchestration入口技能 路由 并行调度skills/25 个 SKILL.md、agents/18 个子代理这条命令该派给谁③ 执行层 execution确定性脚本 质量门scripts/50 个 Python 脚本、hooks/具体怎么算、怎么校验第 1 层指令层Directive——项目的宪法CLAUDE.md 是整个插件的说明书目录结构、30 多个/seo命令表、开发规范如 SKILL.md 不超过 500 行、安全规则凭据永不入库、所有 URL 先过 SSRF 校验、报告生成规范等。它是所有子技能共享的上下文地基让任何代理在动手前都遵循同一套纪律。第 2 层编排层Orchestration——总调度台以全站审计/seo audit url为例流程是这样的渲染首页通过共享渲染器抓取原始 HTML 与渲染后内容自动识别 SPA 站点识别行业类型自动判断是 SaaS、本地商家、电商、媒体还是代理公司并行派发子代理最多 15 个专家同时开工——8 个固定出场technical、content、schema、sitemap、performance、visual、geo、sxo7 个条件出场比如检测到 Google API 凭据才派seo-google发现是本地商家才派seo-local聚合打分各代理结果汇总成 0–100 的健康分 按 Critical/High/Medium/Low 排序的行动清单。这一层的核心是 skills/ 下的 SKILL.md 路由表每个命令都明确知道该转发给哪个子技能、附带哪些参数。审计技能的具体工作流、评分权重技术 SEO 22%、内容质量 23%、On-Page 20%……都写在其 SKILL.md 中。第 3 层执行层Execution——真正干活的手执行层由 scripts/ 下 50 多个 Python 脚本组成每个脚本职责单一、输出结构化 JSONfetch_page.py 抓页面、render_page.py 做无头渲染、pagespeed_check.py 查 Core Web Vitals、gsc_query.py 调 Search Console、drift_compare.py 跑 17 条漂移对比规则……还有一个容易忽略的质量门hooks/hooks.json 配置了 PostToolUse 钩子每次写入文件后自动调用 hooks/validate-schema.py 做 Schema 校验从机制上防止坏结构数据进入报告。三层分离的价值改指令不动脚本改脚本不改说明改说明不碰调度——每层可独立演进这是它能平滑从 v1 迭代到 v2 的关键。子技能自动发现机制命名约定如何替代注册表传统插件系统通常要注册每个模块而 Claude SEO 用的是更简单的套路命名约定 目录扫描 元数据描述三步完成自动发现。第 1 步目录扫描。Claude Code 加载插件时会自动扫描skills/seo-*/下的 SKILL.md 与agents/seo-*.md。符合seo-前缀的文件即被识别为可调用组件——目前自动发现出 25 个子技能 18 个子代理零行注册代码。第 2 步读取 YAML frontmatter。每个组件文件头部都带name、description子代理还有tools声明等元数据。description 里写满了激活关键词和具体使用场景例如审计技能写的是Use when user says audit, full SEO check, analyze my site, or website health check——模型正是靠这段话判断该不该调用它。第 3 步渐进式披露Progressive Disclosure。平时只加载元数据几十字命中激活条件才加载正文指令正文不够用时再按需读references/里的参考文件。这避免了 25 个子技能同时塞满上下文也解释了为什么主 SKILL.md 能保持精简。这套机制最妙的地方在于扩展零改动。按 docs/ARCHITECTURE.md 的扩展点约定新建skills/seo-xxx/SKILL.md带 frontmatter并在主技能里加一条路由新子技能即刻可用新建agents/seo-xxx.md同理。社区贡献的语义聚类seo-cluster、漂移监控seo-drift、电商seo-ecommerce就是这么长出来的。可选扩展同样复用这一约定extensions/ 下每个扩展DataForSEO、Firecrawl、Banana、Ahrefs、SE Ranking、Profound、Bing Webmaster、Unlighthouse自带install.sh把子技能/子代理镜像拷贝进插件目录——主系统再次自动发现无需修改任何核心文件。详见 docs/MCP-INTEGRATION.md。上手体验架构落地只需要几条命令理解架构后上手其实很轻安装macOS/Linuxgit clone --depth 1 https://gitcode.com/gh_mirrors/cl/claude-seo后运行 install.shWindows 用 install.ps1。全站审计/seo audit https://example.com单页分析/seo page https://example.com/about完整命令参考docs/COMMANDS.md安装指南docs/INSTALLATION.md常见问题 FAQQ为什么用 3 层而不是把所有逻辑写在一个大 SKILL.md 里单文件方案在 25 个模块规模下会迅速膨胀到上下文装不下。3 层分离后指令层管纪律、编排层管调度、执行层管计算各自可独立测试和演进。Q不加任何扩展自动发现还成立吗成立。核心 25 个子技能 18 个子代理全部随仓库自带扩展MCP 扩展只是往同一个目录约定里插更多组件。Q审计为什么只要 10–15 分钟编排层的并行派发让技术、内容、Schema、性能等分析同时跑而非串行排队这是 3 层架构带来的直接工程收益。总结Claude SEO 的 3 层架构与子技能自动发现机制本质是把插件注册变成了文件命名 元数据描述指令层CLAUDE.md立规矩编排层skills/、agents/做路由与并行调度执行层scripts/、hooks/确定性执行并守质量门自动发现让每个新模块放进约定目录即生效扩展生态因此能持续生长。想深挖细节建议按顺序读docs/ARCHITECTURE.md → docs/COMMANDS.md → docs/MIGRATION-v1-to-v2.md。掌握这套约定优于注册的设计思路对理解所有 Claude Code 技能插件都有帮助。【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 25 sub-skills 18 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, semantic clustering, e-commerce SEO, international SEO, Google APIs, and PDF/Excel reporting. Optional DataForSEO, Firecrawl, and Banana extensions.项目地址: https://gitcode.com/gh_mirrors/cl/claude-seo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Claude SEO架构深度剖析揭秘3层设计与子技能自动发现机制【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 25 sub-skills 18 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, semantic clustering, e-commerce SEO, international SEO, Google APIs, and PDF/Excel reporting. Optional DataForSEO, Firecrawl, and Banana extensions.项目地址: https://gitcode.com/gh_mirrors/cl/claude-seoClaude SEO 是面向 Claude Code 的开源 SEO 分析技能插件由 1 个主技能orchestrator、25 个子技能sub-skills和 18 个子代理sub-agents协同工作覆盖技术 SEO、内容质量、Schema、GEO/AEO、本地 SEO 等 8 大领域。它能并行派发最多 15 个专家代理几分钟内完成整站审计。很多用户装完就用了却不清楚背后为什么是3 层结构、新子技能又是怎么被自动发现的。这篇文章用尽量少的术语把这两个核心机制讲透。一张图看懂 Claude SEO 的 3 层架构Claude SEO 遵循 Agent Skills 开放标准采用3 层架构directive → orchestration → execution即指令层 → 编排层 → 执行层。官方架构文档在 docs/ARCHITECTURE.md项目总览见 CLAUDE.md。层角色核心目录回答的问题① 指令层 directive项目级说明与全局规则CLAUDE.md、AGENTS.md整个项目怎么运作② 编排层 orchestration入口技能 路由 并行调度skills/25 个 SKILL.md、agents/18 个子代理这条命令该派给谁③ 执行层 execution确定性脚本 质量门scripts/50 个 Python 脚本、hooks/具体怎么算、怎么校验第 1 层指令层Directive——项目的宪法CLAUDE.md 是整个插件的说明书目录结构、30 多个/seo命令表、开发规范如 SKILL.md 不超过 500 行、安全规则凭据永不入库、所有 URL 先过 SSRF 校验、报告生成规范等。它是所有子技能共享的上下文地基让任何代理在动手前都遵循同一套纪律。第 2 层编排层Orchestration——总调度台以全站审计/seo audit url为例流程是这样的渲染首页通过共享渲染器抓取原始 HTML 与渲染后内容自动识别 SPA 站点识别行业类型自动判断是 SaaS、本地商家、电商、媒体还是代理公司并行派发子代理最多 15 个专家同时开工——8 个固定出场technical、content、schema、sitemap、performance、visual、geo、sxo7 个条件出场比如检测到 Google API 凭据才派seo-google发现是本地商家才派seo-local聚合打分各代理结果汇总成 0–100 的健康分 按 Critical/High/Medium/Low 排序的行动清单。这一层的核心是 skills/ 下的 SKILL.md 路由表每个命令都明确知道该转发给哪个子技能、附带哪些参数。审计技能的具体工作流、评分权重技术 SEO 22%、内容质量 23%、On-Page 20%……都写在其 SKILL.md 中。第 3 层执行层Execution——真正干活的手执行层由 scripts/ 下 50 多个 Python 脚本组成每个脚本职责单一、输出结构化 JSONfetch_page.py 抓页面、render_page.py 做无头渲染、pagespeed_check.py 查 Core Web Vitals、gsc_query.py 调 Search Console、drift_compare.py 跑 17 条漂移对比规则……还有一个容易忽略的质量门hooks/hooks.json 配置了 PostToolUse 钩子每次写入文件后自动调用 hooks/validate-schema.py 做 Schema 校验从机制上防止坏结构数据进入报告。三层分离的价值改指令不动脚本改脚本不改说明改说明不碰调度——每层可独立演进这是它能平滑从 v1 迭代到 v2 的关键。子技能自动发现机制命名约定如何替代注册表传统插件系统通常要注册每个模块而 Claude SEO 用的是更简单的套路命名约定 目录扫描 元数据描述三步完成自动发现。第 1 步目录扫描。Claude Code 加载插件时会自动扫描skills/seo-*/下的 SKILL.md 与agents/seo-*.md。符合seo-前缀的文件即被识别为可调用组件——目前自动发现出 25 个子技能 18 个子代理零行注册代码。第 2 步读取 YAML frontmatter。每个组件文件头部都带name、description子代理还有tools声明等元数据。description 里写满了激活关键词和具体使用场景例如审计技能写的是Use when user says audit, full SEO check, analyze my site, or website health check——模型正是靠这段话判断该不该调用它。第 3 步渐进式披露Progressive Disclosure。平时只加载元数据几十字命中激活条件才加载正文指令正文不够用时再按需读references/里的参考文件。这避免了 25 个子技能同时塞满上下文也解释了为什么主 SKILL.md 能保持精简。这套机制最妙的地方在于扩展零改动。按 docs/ARCHITECTURE.md 的扩展点约定新建skills/seo-xxx/SKILL.md带 frontmatter并在主技能里加一条路由新子技能即刻可用新建agents/seo-xxx.md同理。社区贡献的语义聚类seo-cluster、漂移监控seo-drift、电商seo-ecommerce就是这么长出来的。可选扩展同样复用这一约定extensions/ 下每个扩展DataForSEO、Firecrawl、Banana、Ahrefs、SE Ranking、Profound、Bing Webmaster、Unlighthouse自带install.sh把子技能/子代理镜像拷贝进插件目录——主系统再次自动发现无需修改任何核心文件。详见 docs/MCP-INTEGRATION.md。上手体验架构落地只需要几条命令理解架构后上手其实很轻安装macOS/Linuxgit clone --depth 1 https://gitcode.com/gh_mirrors/cl/claude-seo后运行 install.shWindows 用 install.ps1。全站审计/seo audit https://example.com单页分析/seo page https://example.com/about完整命令参考docs/COMMANDS.md安装指南docs/INSTALLATION.md常见问题 FAQQ为什么用 3 层而不是把所有逻辑写在一个大 SKILL.md 里单文件方案在 25 个模块规模下会迅速膨胀到上下文装不下。3 层分离后指令层管纪律、编排层管调度、执行层管计算各自可独立测试和演进。Q不加任何扩展自动发现还成立吗成立。核心 25 个子技能 18 个子代理全部随仓库自带扩展MCP 扩展只是往同一个目录约定里插更多组件。Q审计为什么只要 10–15 分钟编排层的并行派发让技术、内容、Schema、性能等分析同时跑而非串行排队这是 3 层架构带来的直接工程收益。总结Claude SEO 的 3 层架构与子技能自动发现机制本质是把插件注册变成了文件命名 元数据描述指令层CLAUDE.md立规矩编排层skills/、agents/做路由与并行调度执行层scripts/、hooks/确定性执行并守质量门自动发现让每个新模块放进约定目录即生效扩展生态因此能持续生长。想深挖细节建议按顺序读docs/ARCHITECTURE.md → docs/COMMANDS.md → docs/MIGRATION-v1-to-v2.md。掌握这套约定优于注册的设计思路对理解所有 Claude Code 技能插件都有帮助。【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 25 sub-skills 18 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, semantic clustering, e-commerce SEO, international SEO, Google APIs, and PDF/Excel reporting. Optional DataForSEO, Firecrawl, and Banana extensions.项目地址: https://gitcode.com/gh_mirrors/cl/claude-seo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
