技能介绍

要解决的问题

很多站点的 URL 是随手拼出来的：/p/12345 这类 ID 路径让搜索引擎和用户都无法理解页面内容；分类层级过深会稀释权重传递；同一篇文章因为 ?utm_source= 参数或 HTTPS、www、尾斜杠差异被重复收录；动态 URL（/product?id=123）还可能被爬虫绕开。URL 一旦上线再改，牵扯 301 重定向、历史外链和收录重建，成本很高。

核心能力与工作方式

这个技能围绕 On-Page SEO 的 URL 结构展开，核心是三件事：层级设计、格式规范、参数治理。

触发后先做环境勘察：如果存在 .claude/project-context.md 或 .cursor/project-context.md，先读取其中的站点结构信息，再识别现有 URL 模式、分类体系，以及是否涉及中英文多语言路径。

输出通常包含：

URL 结构建议：按 Flat（/page-name）、Category（/blog/post-name）、Nested（/category/subcategory/page）三档模型给出层级方案，并尽量保持层级浅
Slug 约定：3–5 个词、不超过 60 字符、小写加连字符（具体 slug 生成交给 url-slug-generator）
多语言策略：路径前缀（/zh/、/en/）、子域名、ccTLD 的取舍
重定向计划：改动 URL 时给出旧→新的 301 映射

几条硬性规则：用可读单词而非 ID；核心内容避免查询参数，跟踪参数一律 canonical 回基础 URL；会话 ID 只能放 cookie，不能出现在可索引 URL 里；省略 .html、.php 等扩展名，保持技术栈无关；动态 URL 参数控制在 2 个以内，并用 robots-txt 的 Clean-param 与 canonical-tag 处理重复变体。

适用边界

这是一份咨询型技能：给出结构方案、约定和重定向清单，不直接改写服务器配置，也不触碰线上部署。涉及批量改 URL、发布或部署等外部写入时，需先确认目标与影响范围再执行。迁移场景（301 映射、canonical）建议配合 canonical-tag 技能；查询参数治理配合 robots-txt。