优化网站 URL 结构时：提升可读性、层级与 SEO 友好度

当需要规划或修复 URL 层级、格式、参数与多语言结构以优化 SEO 时使用。

适用场景

解决思路

1. 先检查项目上下文：若存在 `.claude/project-context.md` 或 `.cursor/project-context.md`，读取其中的站点结构信息。
2. 识别站点结构：分类、子分类、内容类型。
3. 识别当前 URL：现有模式与问题。
4. 识别多语言需求：zh/en 的 URL 结构（如 /zh/、/en/ 或子域名）。
5. URL 可读性：使用单词而非 ID，如 `/blog/seo-guide` 而非 `/p/12345`。
6. URL 简短：越短通常越好，避免不必要的层级深度。
7. URL 关键词：在自然的情况下包含目标关键词。
8. URL 小写：使用小写，避免大小写混用。
9. URL 连字符：用连字符分隔单词，如 `seo-guide`。
10. URL 避免项：避免特殊字符、核心内容使用查询参数、会话 ID。
11. 层级选择——扁平：`/page-name`，适用于简单站点。
12. 层级选择——分类：`/blog/post-name`、`/tools/tool-name`，适用于内容站点。
13. 层级选择——嵌套：`/category/subcategory/page`，适用于深层级（保持浅层）。
14. 多语言——路径前缀：`/zh/page`、`/en/page`。
15. 多语言——子域名：`zh.example.com`、`en.example.com`。
16. 多语言——ccTLD：`example.cn`、`example.com`。
17. 静态 URL：`/blog/seo-guide`，直接文件，SEO 最佳，内容稳定时使用。
18. 动态 URL：`/product?id=123`，程序生成，可索引内容避免使用。
19. 伪静态 URL：`/blog/seo-guide`（由 `.php` 重写而来），结合两者，CMS 中常见。
20. 规则：优先静态或伪静态；若为动态，参数保持 ≤2；使用 canonical-tag 和 robots-txt（Clean-param）。
21. 省略文件扩展名：去掉 `.html`、`.php`、`.aspx`，使 URL 与技术无关、更短、更易重构，如 `/seo-guide` 而非 `/seo-guide.html`。
22. UTM/跟踪参数：canonical 指向基础 URL；参数仅放在查询字符串中。
23. 搜索结果：canonical 指向搜索页；避免索引结果 URL。
24. 筛选/排序：canonical 指向基础 URL；或用 robots-txt Clean-param。
25. 会话 ID：使用 cookie；绝不放入可索引 URL。
26. 新站点：提前规划层级，避免后期重构。
27. 迁移：做 301 映射；使用 canonical；参考 canonical-tag。
28. 大型站点：动态 URL、参数、多语言——使用 canonical + robots。
29. SEO 审计：检查结构、参数、canonical 一致性。
30. 长 URL：缩短，移除冗余词。
31. 动态参数：使用 canonical；在 robots 中清理参数（Yandex Clean-param）。
32. 大小写混用：重定向到小写。
33. URL 变更：将旧 URL 301 重定向到新 URL。
34. 输出 URL 结构建议。
35. 输出 slug 约定。
36. 输出关键内容类型的层级。
37. 若变更 URL，输出重定向计划。
38. 参考：Alignify URL optimization（https://alignify.co/zh/seo/url-optimization）；Google URL guidelines（https://developers.google.com/search/docs/crawling-indexing/url-structure）。

适用边界 · 注意事项

• 仅需为单个页面生成 slug 措辞时，应使用 url-slug-generator。
• 仅需处理 canonical 合并（HTTPS、www、尾斜杠）时，应使用 canonical-tag。
• 站点结构尚未定义时，应先使用 website-structure 规划结构与 URL 路径。