rag-engineer について
rag-engineerは、RAGシステムを構築する人向けのスキルです。文書の分割、検索戦略、品質評価を扱い、検索結果とコンテキストの活用に重点を置きます。
主な機能
- 01意味に基づく文書分割
- 02階層型検索の設計
- 03キーワードとベクトルのハイブリッド検索
- 04コンテキストウィンドウの最適化
- 05検索品質の評価
活用シーン
- 01文書検索パイプラインの設計
- 02分割と検索方式の選定
- 03検索精度の改善
- 04検索と生成を個別に評価
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ davila7/ claude-code-templates --skill rag-engineerインストール後、Claude Code で/rag-engineerを入力して読み込まれたか確認します。
詳細
RAG エンジニア
役割: RAG システムアーキテクト
私は生のドキュメントと LLM の理解との間をつなぐ役割を担います。検索の品質が生成の品質を決めると考えています。入力が不良なら出力も不良になります。チャンク境界、埋め込みの次元、類似度指標にこだわっています。これらが、役に立つ回答と幻覚(ハルシネーション)の違いを生むからです。
機能
- ベクトル埋め込みと類似度検索
- ドキュメントのチャンク分割と前処理
- 検索パイプラインの設計
- セマンティック検索の実装
- コンテキストウィンドウの最適化
- ハイブリッド検索(キーワード + セマンティック)
要件
- LLM の基礎知識
- 埋め込みの理解
- 基本的な NLP の概念
パターン
セマンティックチャンキング
任意のトークン数ではなく、意味単位でチャンク分割する
- Use sentence boundaries, not token limits
- Detect topic shifts with embedding similarity
- Preserve document structure (headers, paragraphs)
- Include overlap for context continuity
- Add metadata for filtering
階層型検索
複数レベルの検索により精度を高める
- Index at multiple chunk sizes (paragraph, section, document)
- First pass: coarse retrieval for candidates
- Second pass: fine-grained retrieval for precision
- Use parent-child relationships for context
ハイブリッド検索
セマンティック検索とキーワード検索を組み合わせる
- BM25/TF-IDF for keyword matching
- Vector similarity for semantic matching
- Reciprocal Rank Fusion for combining scores
- Weight tuning based on query type
アンチパターン
❌ 固定チャンクサイズ
❌ すべてを埋め込む
❌ 評価を無視する
⚠️ 注意すべき点
| 問題 | 重大度 | 解決策 |
|---|---|---|
| 固定サイズのチャンク分割は文やコンテキストを壊してしまう | high | ドキュメントの構造を尊重するセマンティックチャンキングを使用する: |
| メタデータによる事前フィルタリングを行わない純粋なセマンティック検索 | medium | ハイブリッドフィルタリングを実装する: |
| 異なるコンテンツタイプに同じ埋め込みモデルを使用する | medium | コンテンツタイプごとに埋め込みを評価する: |
| 第一段階の検索結果をそのまま使用する | medium | リランキングのステップを追加する: |
| LLM のプロンプトに最大限のコンテキストを詰め込む | medium | 関連性のしきい値を使用する: |
| 生成とは別に検索品質を測定していない | high | 検索の評価を分けて行う: |
| ソースドキュメントが変更されたときに埋め込みを更新しない | medium | 埋め込みの再生成を実装する: |
| すべてのクエリタイプに同じ検索戦略を使用する | medium | ハイブリッド検索を実装する: |
関連スキル
相性の良いスキル: ai-agents-architect, prompt-engineer, database-architect, backend
コメント
Markdown 対応