用途：docs-seo 是面向文档站点的技术 SEO 技能，专注文档站特有的失效模式，例如同一页面按版本和语言各存在一份、标题与 canonical 来自生成器配置、预览分支泄漏进索引、大量自动生成的参考页既最薄又意图最高。它只修复站点发布层面的问题：搜索引擎能抓取什么、重复 URL 中哪个胜出、每页标题与摘要怎么写、页面之间如何互链。它不决定目标查询、不写内容、不追逐 AI 答案引用，这些分别路由到关键词研究、文档结构审计、故障排查文档、面向编码智能体的文档优化和 devrel 分析等技能。
主要能力：先通过访谈确认文档 URL、生成器与托管平台、是否版本化与翻译、能否访问 Search Console、是否有自动生成的 API/CLI 参考树、是否有预览或分支部署、由谁落地修复、截止日期与可接受的 URL 变更幅度。若用户无法修改生成器配置或部署，技能会直接停止，因为几乎所有修复都是模板或配置改动。随后按抓取、索引、渲染、信号的顺序推进：用脚本从 sitemap 构建抓取集，记录状态码、标题、描述、canonical、robots 指令、首个 h1、词数与内外链数量，并检查 robots.txt、sitemap 本身和禁用 JavaScript 后的页面。
使用方式：典型命令为 python3 scripts/docs-seo-crawl.py https://docs.example.com/sitemap.xml --out pages.csv --summary，也可用 --limit、--delay、--urls、--format json 等参数；无脚本环境时按入口页、每节十页、参考树二十页手工抽样，并在报告中说明是抽样。
适用场景与限制：适用于版本化、多语言、含自动生成参考树的文档站 SEO 审计与修复，包括版本与翻译姿态选择（stable-canonical、latest-only、per-version indexable）、hreflang 校验、模板级标题与描述改写、内链与页面体验检查。限制是它不负责内容创作、关键词策略与 AI 引用获取；结构化数据方面建议跳过 HowTo 与 FAQPage，字符数只作提示而非门槛。