CMKiller

ベクトルDB（CMKiller）への取り込みと、Lv3 Agentic 検索プロトコル + Reranker (Jina v2) 搭載の RAG 検索 CLI / Claude Code スキル。

v1.2 RAG Agentic Reranker macOS

🆕 v1.2 新機能（2026-05-05）

cmk rerank-search — Jina Reranker v2 で Top-K → Top-N に精製。失敗検索率 -30%
setup.sh --add-jina — 既存環境を壊さず JINA_API_KEY だけ追加
Step 3.5 プロトコル — Agentic 検索の判断ツリーに Reranker 段階を統合

既存ユーザーのアップグレード手順

# スキル本体を更新
curl -fsSL https://aivest-skills.pages.dev/cmkiller/install | bash

# Reranker を有効化（任意、Jina API key が必要）
~/.claude/skills/cmkiller/setup.sh --add-jina

Jina API key は jina.ai/?sui=apikey で無料取得（1Mトークン/月の無料枠）。

インストール（新規）

1コマンドで導入できます（Claude Code がインストール済みの macOS が前提）。

curl -fsSL https://aivest-skills.pages.dev/cmkiller/install | bash

入力を求められるもの

CMKILLER_API_KEY（CMKiller の /settings で発行する cmk_...）
CMKILLER_BASE_URL（自前ホスト URL。デフォルトは https://cmkiller.vercel.app）
JINA_API_KEY（任意、Reranker 用。空でEnterで後で追加可）

このスキルでできること

取り込み: Web 記事 / PDF / YouTube / Markdown を CMKiller の ExternalSource へ自動投入
検索: internal（Zoom 録画） / external（外部資料） / all（統合）の3モード
Lv3 Agentic 検索: 質問タイプ判定 → クエリ展開 → 並列検索 → 自己評価 → 文脈拡張 → 出典付き統合回答
Collection / Source CRUD: 整理・移動・削除を CLI で完結

Lv3 Agentic 検索プロトコル

Claude Code がスキルを発動すると、以下の判断ツリーで RAG 検索を行います。 外部スクリプトに委譲せず、Claude Code 自身がエージェント本体として動きます。

Step 0: 質問タイプ判定

タイプ	例	戦略
A. 単純検索	「事例72って何？」	`cmk search` 1回
B. 抽象 / 複合	「LP 冒頭で何を言うべきか」	クエリ展開 → 並列 → 統合
C. 比較	「A と B はどう違う？」	各々独立検索 → 比較
D. 列挙	「手法を5つ挙げて」	多様性重視で複数 source 抽出

Step 3: 結果評価（自己評価ループ）

状況	対応
全部 sim<0.4	別語彙で retry（最大2回）
Top-3 同じ source 偏り	多様性追加検索 / 全文取得
Top-1 突出（>0.6）	`cmk source get` で全文取得して詳細抽出
0件ヒット	広い言い換え→ダメなら「該当情報なし」と明記

必須出力フォーマット（ハルシネーション防止）

## 結論
- 主張1 [出典番号]
- 主張2 [出典番号]

## 詳細
（出典明記）

## 出典
[1] タイトル (sim=0.XX)
[2] タイトル (sim=0.XX)

## 検索プロセス
- サブクエリ: [...]
- retry: N回
- 信頼度: high / medium / low

使い方の例

CLI から

cmk health                                          # 接続確認
cmk search "ヘッドラインの極意" --mode all --limit 5
cmk rerank-search "Russell Brunson セールス" --mode all --limit 5  # 🆕 v1.2
cmk ingest web https://example.com/article --tags "AI,2026"
cmk source list --type web
cmk reindex --force

Reranker (rerank-search) を使うべきシーン

① 長尾固有名詞（マイナーな用語、人名）の検索
② 複数キーワード優先度判定（例: 「YouTube広告 5秒注意」）
③ 同義概念の文脈分離（Russell系 vs Ryan系等）
④ 翻訳・カナ揺れ（「Russell Brunson」⇄「ラッセル・ブランソン」）
⑤ Top-1 信頼性が要る抽象クエリ

単発キーワード検索（例: 「事例72」）は通常 cmk search で十分。Reranker は +500ms レイテンシのため、Top-1 sim > 0.7 の場合は不要。

Claude Code から

「CMKillerに入れて」「RAGに追加」「LPの冒頭で何を言うべきか調べて」等の発話で自動発動します。Lv3 プロトコルに従って Claude Code が複数回 cmk search を呼び、出典付きで統合回答します。

動作要件

macOS（Linux / WSL は順次対応）
Claude Code インストール済み
curl, tar, jq, dotenvx
CMKiller の API key（自前ホスト or AIVEST 提供版）

ファイル構成

~/.claude/skills/cmkiller/
├── SKILL.md       # スキル定義 + Agentic プロトコル仕様
├── cmk            # CRUD / 検索 CLI 本体
└── setup.sh       # 初回セットアップ（dotenvx 暗号化 + Keychain 連携）

セキュリティ

API key は dotenvx で暗号化して ~/.cmkiller.env に保存
復号鍵は macOS Keychain に保管（cmkiller-dotenvx サービス）
平文の .env.keys はインストール完了時点で削除

アンインストール

rm -rf ~/.claude/skills/cmkiller
rm ~/.cmkiller.env
security delete-generic-password -s "cmkiller-dotenvx" -a default