site-architecture
作者 alirezarezvanisite-architecture 可帮助 AI agents 审计并规划网站结构、URL 层级、导航、抓取路径、面包屑和内部链接，用于 Technical SEO。它包含 URL design 与 internal linking 指南，并提供 sitemap analyzer 脚本，用于基于证据生成网站架构优化建议。
该技能评分为 84/100。对于希望让 agent 审计或重设计网站信息架构与内部链接的目录用户来说，它是一个相当稳妥的收录候选。仓库证据显示，它在触发条件清晰度、工作流深度、参考资料和可用分析脚本方面都具备足够基础，相比通用 SEO prompt 能带来更实际的助力；不过在安装与上手引导方面，打包呈现仍可以更清楚。
- frontmatter 中的触发范围清晰，覆盖 site architecture、URL structure、navigation、breadcrumbs、topic clusters、orphan pages 和 structural SEO issues，并明确排除 content strategy 与 schema markup。
- 具备扎实的可执行内容：较长的 SKILL.md、上下文收集提示、11 个 H2 章节、20 个 H3 章节，以及面向 internal linking 和 URL design 的实用参考。
- 包含一个 stdlib Python sitemap analyzer，可检查 sitemap.xml 文件的层级深度、URL patterns、duplicate paths、orphan candidates，并输出 JSON summary。
- 技能目录中没有提供安装命令或 README，因此用户可能需要根据上级仓库的约定自行推断安装方式。
- 现有材料显示它在 SEO 架构指导方面较强，但工作流摘录有部分截断，因此对完整端到端执行细节的判断仍不能完全确定。
site-architecture skill 概览
site-architecture 用来解决什么问题
site-architecture skill 可帮助 AI assistant 审计、重构或规划网站结构，重点面向技术 SEO、可抓取性、导航、URL 规范性和内部链接。当问题本质是结构性问题时，它最有价值：URL 目录混乱、hub 页面薄弱、孤立页面、导航不清晰、抓取路径差，或需要 SEO 安全的信息架构来支撑网站迁移。
最适合的用户和项目
这个 site-architecture skill 适合 SEO 顾问、技术 SEO 团队、内容负责人、创始人，以及需要可执行架构建议而不是泛泛营销建议的开发者。它尤其适用于 SaaS、B2B、内容型网站、文档站、电商类目结构、本地服务网站，以及围绕 topic clusters 或 hub-and-spoke 模型重新组织内容的网站。
它为什么比普通 prompt 更强
普通 prompt 可能只会说“优化内部链接”，但这个 skill 会给 assistant 一个明确工作流：收集当前状态、目标和约束；评估 URL 模式；梳理导航深度；并推荐内部链接模型。该 repository 还包含 references/internal-linking-playbook.md、references/url-design-guide.md 和 scripts/sitemap_analyzer.py，因此它比一份简短的 SEO checklist 更偏实操。
什么时候不适合使用这个 skill
不要把 site-architecture 当作决定要发布哪些新文章、撰写页面文案、实现 schema markup，或从零做 keyword research 的主要工具。它可以通过明确页面应该放在哪里、页面之间应如何连接来辅助这些工作流，但它的核心价值是架构，而不是内容创意或结构化数据。
如何使用 site-architecture skill
site-architecture 安装方式和 repository 路径
通过 GitHub skill repository 安装：
npx skills add alirezarezvani/claude-skills --skill site-architecture
源文件位于 alirezarezvani/claude-skills 中的 marketing-skill/skills/site-architecture。安装后，先阅读 SKILL.md，然后检查：
references/internal-linking-playbook.mdreferences/url-design-guide.mdscripts/sitemap_analyzer.py
这个 skill 文件夹中没有单独的 README 或 metadata 文件，因此主要操作说明在 SKILL.md 和两个 reference guides 中。
能让 site-architecture 使用效果更好的输入
想让 site-architecture 输出更有质量，不要只告诉 assistant “修一下我的 SEO 结构”。这个 skill 在具备以下信息时效果最好：
- 网站 URL，以及 CMS 或 framework
sitemap.xmlURL 或导出的 sitemap- 各 section 的大致页面数量
- 主要商业模式：lead gen、SaaS、e-commerce、media、local、documentation
- 已知问题：孤立页面、重复页面、薄弱类目页、crawl bloat、排名不佳
- 你希望提升排名或保护的重点页面
- 约束条件：不能改 URL、迁移截止日期、CMS 限制、工程资源
更好的 prompt 示例：
Use the
site-architectureskill to audit our B2B SaaS site. Sitemap:https://example.com/sitemap.xml. We have feature pages, solution pages, integrations, docs, and 250 blog posts. Our priority is ranking solution pages without changing existing high-performing blog URLs. Identify structural issues, recommend URL folder rules, navigation changes, hub pages, and internal links. Flag anything that needs redirects or developer work.
架构审计的建议工作流
从证据开始。如果你有 sitemap，可以运行或要求 assistant 使用 scripts/sitemap_analyzer.py 来检查 URL 深度、section 分布、重复路径模式，以及潜在的孤立页面候选项。然后将结果与 url-design-guide.md 对照，找出不一致的 slug、过深的目录、基于日期的 blog 路径、混用 trailing slash 的规则，或命名不清晰的 section。
接下来，使用 internal-linking-playbook.md 选择链接模式。Hub-and-spoke 通常更适合建立主题权威；线性链接适合课程和文档；category-to-product 模型适合电商。如果资源有限，应要求输出按优先级排序的修复清单，而不是一次性完整重构。
实用 prompt 模板
一个完整的 site-architecture 指导 prompt 应包含期望的输出格式。例如：
Produce: 1) current architecture diagnosis, 2) URL rule recommendations, 3) proposed navigation model, 4) internal linking plan by page type, 5) redirect/migration risks, 6) 30-day implementation plan, 7) open questions.
这样可以减少空泛建议，并推动 assistant 给出 SEO、内容和工程团队可以直接接手的决策。
site-architecture skill 常见问题
site-architecture 适合技术 SEO 工作吗？
适合。site-architecture 用于技术 SEO 时，如果任务涉及抓取路径、可索引 URL 模式、网站深度、内部链接、breadcrumbs、重复结构模式，或迁移安全的 URL 决策，会非常契合。除非 log-file analysis、Core Web Vitals debugging 或 schema implementation 与架构相关，否则它不太适合作为这些工作的主要工具。
初学者可以使用这个 skill 吗？
可以，但初学者应提供具体的网站细节，并要求解释。这个 skill 包含实用 reference，因此你可以要求：“explain each recommendation and why it matters for crawlability or rankings.” 第一次使用时，建议先要求诊断，再要求完整重构。
它和普通 SEO prompt 有什么区别？
普通 SEO prompt 往往会给出宽泛建议，比如“增加内部链接”或“缩短 URL”。这个 skill 更结构化：它会区分当前状态、目标、约束、URL 设计、导航和链接架构。内置的 sitemap analyzer 也让它能更好地从原始 sitemap 数据走向可执行发现。
什么时候不建议安装？
如果你只需要 blog topic ideas、metadata rewrites、product descriptions 或 schema snippets，就不建议安装 site-architecture。也不要把它作为高风险迁移的唯一依据；可以用它生成架构方案，但之后仍要用你的 SEO tools 验证 redirects、canonicals、analytics 和 crawl data。
如何改进 site-architecture skill 的输出
给 site-architecture skill 提供真实网站证据
提升 site-architecture 输出质量的最佳方式，是提供 sitemap、当前导航、关键页面类型和排名优先级。如果无法分享域名，可以按 section 提供匿名 URL 示例。真实示例能帮助 assistant 判断问题到底是深度、命名、重复、hub 薄弱，还是缺少链接。
要求做决策，而不只是做观察
较弱的请求是：“What do you think of our structure?” 更好的请求是：
Recommend the preferred URL structure for features, integrations, solutions, blog, and docs. Keep existing ranking blog URLs unchanged unless there is a clear SEO reason to migrate. Mark each recommendation as keep, change, merge, redirect, or investigate.
这会迫使 skill 输出可以落地执行的架构建议。
留意常见失败模式
常见失败模式包括：在没有评估迁移风险的情况下建议改 URL；创建过多 hub 页面；不考虑语义把所有 URL 都拍平；或建议的内部链接在上下文中并不真正有用。可以要求 assistant 将“安全的快速收益项”和“迁移级别变更”分开，并解释每条结构建议背后的 SEO 权衡。
第一版输出后继续迭代
把第一次回答当作架构草图，而不是最终方案。后续补充 crawl data、Search Console exports、analytics priorities、CMS restrictions 或 developer feedback。然后要求 site-architecture skill 将方案修订为分阶段路线图：立即可做的内部链接、导航清理、URL governance rules，以及更长期的结构重组。