docs-lookup

Astro 文档查询

在回答依赖最新文档、精确 API 名称、集成设置、升级路径或版本相关行为的 Astro 问题时，使用此技能。

工作流

1. 明确具体问题

搜索前，将请求缩小到某个具体主题：

• 集成
• 内容集合
• 路由
• 资源和图像
• 渲染模式
• 部署适配器
• 迁移或升级指南

如果用户提供了错误消息，请在查询时直接搜索该消息。

2. 优先使用 Astro 官方来源

从 Astro 官方文档及相关官方参考资料入手。如果 Agent 提供 Astro 文档工具或 MCP，请使用它；否则，请直接搜索官方文档站点。

对于涉及语法、配置或不兼容变更的问题，避免依赖博客文章或社区代码片段。

3. 注意版本差异进行搜索

使用具体的搜索词，不要过于宽泛：

• content collections schema
• view transitions
• netlify adapter output server
• upgrade guide

如果版本可能存在差异，请核实当前版本的行为，不要假定旧示例仍然适用。

4. 提供可直接使用的答案

回复时：

• 直接给出答案
• 在有帮助时附上精简且可运行的代码片段
• 指出注意事项、版本限制或迁移说明
• 如果主题较复杂或可能发生变化，请链接相关 Astro 文档页面

5. 如果首次搜索无果

放弃前，请尝试以下一种方法：

• 使用更具体的搜索词
• 搜索该功能的官方包或适配器名称
• 搜索确切的配置键
• 改查升级或迁移指南，而不是功能页面

回复格式

优质答案通常包括：

1. 简短答案
2. 相关示例
3. 重要注意事项
4. 官方参考资料

如果无法通过当前官方文档核实相关行为，请明确说明，而不要猜测。