用途:在构建 Astro Starlight 文档站点时使用,覆盖侧边栏配置、Pagefind 搜索、插件(blog/openapi/typedoc)、i18n 与 llms.txt。也涵盖带 hreflang 支持的多语言文档、Starlight 内容模型专属的 Content Layer API 集成(docsLoader、schema),以及 CSS 自定义属性主题。不覆盖 Starlight 之外的通用 Astro Content Layer 用法(astro-content)或非 Starlight 的 i18n 路由(astro-i18n),这些由各自技能处理。
主要能力:Starlight 是面向 Astro 的生产级文档主题,内置搜索、深色模式、i18n 与丰富插件生态。适用场景包括构建技术文档站点、创建 API 参考文档(starlight-openapi)、从 TypeScript 类型生成文档(starlight-typedoc)、为文档站添加博客(starlight-blog)、设置版本化文档(starlight-versions)、带 hreflang 的多语言文档。特性包括:内置 Pagefind 全文搜索、零配置;自动深色/浅色模式(CSS 自定义属性);基于文件系统或手动分组的侧边栏配置;插件生态(DocSearch、blog、openapi、typedoc);Content Layer API 与 Astro 内容集合集成;llms.txt 支持(starlight-llms-txt)提升 AI 可发现性;0.42 起无 JS 移动菜单(Popover API,禁用 JS 也可用,附带编译 JS 与 .d.ts)。
使用方式:资料要求实施前用 TeamCreate 生成 3 个代理(explore-codebase 分析现有配置、侧边栏与内容结构;research-expert 通过 Context7/Exa 验证插件 API;mcp__context7__query-docs 查阅 Content Layer 与 i18n 模式),实施后运行 sniper 验证。参考文档包括 setup.md、sidebar-config.md、search.md、plugins.md、i18n-multilang.md、content-layer.md、customization.md,以及 starlight-config.md、sidebar-example.md 模板。
最佳实践:优先使用文件系统侧边栏,仅在需要时添加手动配置;小站点保留 Pagefind,高流量或大型文档用 DocSearch;使用 starlight-llms-txt;用 Content Layer schema 保证 frontmatter 类型安全;用 CSS 自定义属性覆盖主题而非组件插槽。
限制:不覆盖 Starlight 之外的通用 Astro Content Layer 用法与非 Starlight 的 i18n 路由。具体安装命令、版本号与价格等资料未提供。