用途
docs-lookup 是一个用于查询 Astro 官方文档的技能，适合在回答依赖当前文档、确切 API 名称、集成配置、升级路径或版本敏感行为的 Astro 问题时使用。
主要能力
- 将用户请求归纳为具体主题后再搜索，例如：集成、内容集合、路由、资源与图片、渲染模式、部署适配器、迁移或升级指南。
- 如果用户提供了错误信息，会将该错误信息直接作为查询的一部分进行搜索。
- 优先使用 Astro 官方文档及相关官方参考。如果智能体具备 Astro 文档工具或可用的 MCP，则使用它；否则直接搜索官方文档站点。
- 在涉及语法、配置或破坏性变更的问题上，避免依赖博客文章或社区片段。
- 进行版本感知的搜索，使用具体而非宽泛的搜索词，例如：content collections schema、view transitions、netlify adapter output server、upgrade guide。
- 当可能存在版本差异时，验证当前版本的行为，而不是假设旧示例仍然适用。
使用方式
- 明确具体问题：在搜索前将请求缩小到特定主题。
- 优先官方来源：从 Astro 官方文档及相关官方参考开始。
- 版本感知搜索：使用精确搜索词，并在可能时验证当前版本行为。
- 给出可用输出：回复时先给出直接答案，必要时包含最小可用代码片段，指出注意事项、版本约束或迁移说明，并在主题较深或可能变化时链接相关 Astro 文档页面。
- 首次搜索失败时：尝试更窄的搜索词、功能的官方包或适配器名称、确切的配置键，或改用升级/迁移指南而非功能页面。
适用场景
- 回答依赖当前 Astro 官方文档的问题。
- 需要确认确切 API 名称、集成配置、升级路径或版本敏感行为。
- 用户提供错误信息，需要基于官方文档进行排查。
限制
- 如果无法从当前官方文档验证行为，应明确说明，而不是猜测。
- 关于收费、价格、平台、效果或具体使用步骤等未在资料中提供的信息，暂未提供。