site-architecture

site-architecture 技能概览

site-architecture 是做什么的

site-architecture 技能帮助你设计或审查搜索引擎和 AI 爬虫真正能够发现并理解的技术基础。它关注 robots.txt、sitemap、meta 标签、爬取访问权限、Core Web Vitals 等实际的网站结构选择，因此当可见性不只取决于内容质量时，它尤其有用。

适合哪些用户和任务

如果你正在上线新站、修复收录问题，或者为内容量很大的站点做 SEO 内容发现准备，就该用 site-architecture skill。它特别适合开发者、SEO 负责人和编辑，他们需要的不是泛泛的 SEO 建议，而是一套清晰的技术方案。

它和其他工具有什么不同

这个技能不只是一个关于“SEO”的提示词。它同时强调传统搜索引擎和 AI 爬虫（例如 GPTBot、ClaudeBot、PerplexityBot）的可发现性，以及通过 Open Graph 和 Twitter Cards 实现的社交预览。它的核心价值，是把架构决策落到可抓取、可收录的页面上，减少那些隐藏的阻碍。

什么时候适合，什么时候不适合

当问题出在全站结构、爬取访问权限或元数据一致性时，它非常适合。若你只需要一条单独的 meta description、一个内容简报，或者不涉及技术发布层的设计反馈，它就没那么合适。

如何使用 site-architecture 技能

安装并打开正确的文件

对于 site-architecture install，请在你要审查或配置的网站同一工作区中使用这个技能，然后先打开 SKILL.md。这个仓库刻意做得很轻量，所以最有价值的指导都在这个文件里。它没有配套脚本或辅助文件夹可依赖，这意味着你需要仔细阅读规则，并把它们应用到自己的技术栈上。

该提供给技能什么信息

site-architecture usage 这种用法在你提供站点类型、平台和当前约束时效果最好。一个强输入示例是：“审查我们基于 Next.js 的营销站点，重点看可爬取性、sitemap 覆盖和 AI bot 访问；我们只希望公开页面被收录。” 这样能让技能给出有用的技术建议，而不是泛泛的最佳实践。

如何提问，才能得到更好的输出

把 site-architecture guide 当作工作流，而不是检查清单。你可以直接要求以下某一种结果：

• 针对特定环境的 robots.txt 草案
• 面向公开与私有 URL 的 sitemap 策略
• 模板和页面类型的 metadata 规则
• 针对现有网站结构的爬取/收录审查

如果你需要 site-architecture for SEO Content，请说明哪些内容页最重要、它们是如何生成的，以及哪些页面应该排除在搜索之外。这样技能才能在可见性和排除之间做平衡，而这才是真正的架构取舍。

先读哪些文件

先从这里开始：

• skills/site-architecture/SKILL.md

然后检查你自己仓库中所有匹配以下内容的相关路径：

• robots.txt
• sitemap.xml 或 sitemap 生成器
• HTML templates
• public asset directories

因为这个技能仓库本身没有额外的支持文件，所以你的落地质量取决于你是否能把它的规则准确映射到真实的网站结构上。

site-architecture 技能 FAQ

site-architecture 只适合开发者吗？

不是。site-architecture skill 对 SEO、内容团队和站点所有者同样有用，只是最终改动通常还是由开发者来实现。非开发者的价值，在于在代码修改之前先把爬取和收录策略定义清楚。

它和普通提示词有什么区别？

普通提示词通常会问“SEO 最佳实践”，然后得到很泛的输出。site-architecture 的范围更窄：它聚焦爬取访问、发现、元数据和技术约束。因此，当你需要的是会影响收录的决策，而不只是文案建议时，它更合适。

它适合新手吗？

适合，只要你能把自己的网站描述清楚。这个技能对新手友好的地方在于，它能把技术问题梳理成结构化思路，但你仍然需要一些基本事实，比如平台类型、公开/私有 URL 规则，以及站点是否应该被收录。

什么时候不该用它？

如果任务纯粹是创意性的，比如写首页文案或给产品命名，就不要用 site-architecture。如果网站根本没有爬取或收录方面的需求，它也不是合适的工具，因为这些架构建议只会带来不必要的负担。

如何改进 site-architecture 技能

提供真正重要的约束条件

最好的输出来自明确写出平台、托管模式和收录目标的输入。说明你是静态托管、SSR、CMS 驱动发布，还是混合架构；同时也要说明哪些部分必须阻止爬虫访问。这样可以减少猜测，让建议真正可落地。

不要只给首页，要给页面类型

想提升 site-architecture 的结果，请列出主要的 URL 类型：产品页、博客文章、分类页、文档页、登录页、管理后台，以及筛选后的搜索页。这样技能就能把可收录模板和应该排除的 URL 区分开来，而这往往正是干净架构和无意浪费爬取资源之间的分界线。

留意常见失败模式

最常见的问题包括：在 robots.txt 里误封有价值的页面、暴露重复或低价值 URL，以及在不同模板之间不一致地发布 metadata。如果第一次输出显得很泛，问题通常不是技能本身，而是输入太弱：缺少 URL 示例、内容优先级不清楚，或者没有提到技术栈限制。

用证据继续迭代

第一次输出后，请拿建议去对照线上文件和日志：确认 sitemap 覆盖情况，检查 robots.txt，并查看几个代表性页面渲染后的 metadata。然后只针对有问题的部分继续让技能细化，比如“针对 faceted URLs 调整”或“收紧 staging 和 production 的 bot 访问权限”。这样可以让 site-architecture 技能保持聚焦，并在第二轮给出更好的技术决策。