docs-lookup について
docs-lookupは、最新ドキュメント、正確なAPI名、統合手順、バージョン依存の挙動に関するAstroの質問に答えるスキルです。Astro公式資料を優先し、焦点を絞った検索と実用的で簡潔な回答を支援します。
主な機能
- 01質問を具体的なトピックに絞る
- 02Astro公式ドキュメントを優先
- 03バージョンを考慮した検索
- 04正確なエラーや設定語句の利用
- 05例や注意点を含む回答の構成
活用シーン
- 01現在のAstro API動作の確認
- 02統合設定手順の検索
- 03アップグレードや移行方法の調査
- 04バージョン固有のAstroエラーの解決
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ incluud/ astro-agent-skills --skill docs-lookupインストール後、Claude Code で/docs-lookupを入力して読み込まれたか確認します。
詳細
Astro ドキュメントの検索
最新のドキュメント、正確な API 名、インテグレーションの設定、アップグレード手順、またはバージョンに依存する動作に基づいて Astro に関する質問に回答するときは、このスキルを使用してください。
ワークフロー
1. 質問を具体的に定義する
検索する前に、リクエストを具体的なトピックに絞り込みます。
- インテグレーション
- コンテンツコレクション
- ルーティング
- アセットと画像
- レンダリングモード
- デプロイアダプター
- 移行またはアップグレードガイド
ユーザーがエラーメッセージを提示した場合は、そのメッセージを検索に含めて直接調べてください。
2. 公式 Astro ソースを優先する
まず、公式 Astro ドキュメントと関連する公式リファレンスを確認します。エージェントが Astro ドキュメントのツールや MCP を利用できる場合は、それを使用してください。利用できない場合は、公式ドキュメントサイトを直接検索してください。
構文、設定、破壊的変更に関する質問では、ブログ記事やコミュニティのスニペットに頼らないでください。
3. バージョンを考慮して検索する
幅広い検索語ではなく、具体的な検索語を使用します。
content collections schemaview transitionsnetlify adapter output serverupgrade guide
バージョンによる違いがあり得る場合は、古い例が今も当てはまると決めつけず、現在のバージョンでの動作を確認してください。
4. 実用的な形式で回答する
回答する際は、次の点に従ってください。
- まず、質問に直接答える
- 必要に応じて、最小限の動作するコード例を含める
- 注意点、バージョンの制約、移行に関する注記を明示する
- 内容が複雑な場合や変更される可能性が高い場合は、関連する Astro ドキュメントのページにリンクする
5. 最初の検索で見つからない場合
諦める前に、次のいずれかを試してください。
- 検索語をさらに絞り込む
- 機能の公式パッケージ名またはアダプター名で検索する
- 正確な設定キーで検索する
- 機能のページではなく、アップグレードガイドまたは移行ガイドを確認する
回答の構成
適切な回答には、通常、次の内容が含まれます。
- 簡潔な回答
- 関連する例
- 重要な注意点
- 公式リファレンス
現在の公式ドキュメントから動作を確認できない場合は、推測せず、その旨を明確に伝えてください。
コメント
Markdown 対応