用途:在构建 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 和丰富插件生态。特性包括:内置 Pagefind 全文搜索、零配置;自动深色/浅色模式,基于 CSS 自定义属性;侧边栏支持基于文件系统或手动分组;插件生态含 DocSearch、blog、openapi、typedoc;Content Layer API 集成 Astro 7 内容集合;llms.txt 支持(starlight-llms-txt)提升 AI 可发现性;0.42 起无 JS 移动菜单(Popover API),并附带编译后的 JS 与 .d.ts。
使用方式:技能要求先并行启动三个 Agent 调用(fuse-ai-pilot:explore-codebase 分析现有配置、侧边栏与内容结构;fuse-ai-pilot:research-expert 通过 Context7/Exa 验证插件 API;mcp__context7__query-docs 查阅 Content Layer 与 i18n 模式),实现后运行 fuse-ai-pilot:sniper 验证。参考文档涵盖 setup、sidebar-config、search、plugins、i18n-multilang、content-layer、customization,并提供 starlight-config 与 sidebar-example 模板。
适用场景:技术文档站点、API 参考文档(starlight-openapi)、从 TypeScript 类型生成文档(starlight-typedoc)、为文档站添加博客(starlight-blog)、版本化文档(starlight-versions)、带 hreflang 的多语言文档。
最佳实践与限制:优先使用文件系统侧边栏,仅在需要时手动配置;小型站点保留 Pagefind,高流量或大型文档用 DocSearch;使用 starlight-llms-txt;用 Content Layer schema 保证 frontmatter 类型安全;用 CSS 自定义属性覆盖主题而非组件插槽。具体安装命令、版本与收费信息暂未提供。