keyword-expansion について
keyword-expansion は、検索範囲の不足やノイズ、別名の多さに対応して `queries.md` を整えるスキルです。トピックの範囲を保ちながら、キーワードと除外語を追加します。
主な機能
- 01同義語や関連語を追加
- 02誤検出を招く語を除外
- 03クエリ変更の理由を記録
- 04`DECISIONS.md` の範囲制約を確認
活用シーン
- 01検索漏れを減らす
- 02誤検出によるノイズを抑える
- 03範囲を広げずに別名を整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ willoscar/ research-units-pipeline-skills --skill keyword-expansionインストール後、Claude Code で/keyword-expansionを入力して読み込まれたか確認します。
詳細
スキル:キーワード拡張
トリガーとルーティング
- トリガー:キーワード拡張、同義語、除外語、queries.md、关键词扩展、同义词、排除词。
- 使用する場面:検索範囲の網羅性が不足している、ノイズが多すぎる、またはテーマに別名が多く、検索語を体系的に拡張・絞り込む必要がある場合。
- 使用を避ける場面:
queries.mdで十分な範囲を安定して検索できている場合(範囲の拡大により、後続のコストが膨れ上がるのを避けます)。 - ネットワーク:なし。
- ガードレール:クエリ数を管理可能な範囲に保ち、除外語を明確にし、「無限に拡張」しないようにします。
目標
- 範囲を逸脱せずに、
queries.mdの再現率と適合率を向上させます。
入力
queries.md- 任意:
DECISIONS.mdのスコープに関するメモ
出力
- 更新した
queries.md
手順(必ず従うこと)
- 現在のテーマの範囲と除外事項を抽出します。
- キーワードの拡張案(同義語、関連用語、頭字語)を提示し、よくある誤検出を避けるための明示的な除外語を追加します。
- 変更ごとに明確な「理由」のメモを添えて、
queries.mdを更新します。
受け入れ基準(必ず確認すること)
-
queries.mdに更新したキーワードと除外語が含まれている。 - 変更内容が
DECISIONS.mdのスコープ制約と矛盾していない。
トラブルシューティング
問題:キーワード拡張により範囲が逸脱する
対処:
DECISIONS.mdのスコープに関するメモを読み直し、よくある誤検出を避けるための明示的な除外語をqueries.mdに追加します。
問題:クエリ数が膨れ上がり、管理できなくなる
対処:
- シグナルの強いクエリを少数に絞り、可能な限り類義語を同じクエリにまとめ、多数の似通ったクエリを追加しないようにします。
コメント
Markdown 対応