ctx-index について
ctx-index は、後で検索できるようローカルプロジェクトの内容をインデックス化するスキルです。`ctx_index` MCP ツールまたは `context-mode` CLI を使い、対象範囲や除外パスを指定して安全に処理し、対象と件数を報告します。
主な機能
- 01ローカルプロジェクトのインデックス化
- 02`ctx_index` MCP ツールを優先
- 03利用できない場合は CLI を使用
- 04範囲の指定とパスの除外
- 05対象と件数の報告
活用シーン
- 01後の検索に向けたリポジトリの準備
- 02機密情報や生成ファイルの除外
MCP 対応
パスのインデックス化には `ctx_index` MCP ツールを優先し、利用できない場合は `context-mode index` CLI コマンドを使います。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mksglu/ context-mode --skill ctx-indexインストール後、Claude Code で/ctx-indexを入力して読み込まれたか確認します。
詳細
Context Mode インデックス
後で検索できるように、ローカルプロジェクトのコンテンツをインデックス化します。
手順
- 利用可能な場合は、
ctx_indexMCP ツールを優先してください。 - ユーザーがパスを指定しておらず、現在のプロジェクトルートが不明確な場合にのみ、パスを尋ねてください。
- ファイルのバイト列が会話に含まれないよう、大きなインラインの
contentではなく、pathを使用してください。 - リポジトリのインデックス化では、保守的な上限値と明確なソースラベルを指定してください。
ctx_index({
path: ".",
source: "project:<name>",
maxDepth: 5,
maxFiles: 200
})
- MCP ツールを利用できない場合は、CLI にフォールバックしてください。
context-mode index . --source project:<name>
- インデックス化したソースラベル、ファイル数またはセクション数、および対応する検索コマンドを報告してください。
ctx_search({ source: "project:<name>", queries: ["..."] })
安全性
- 依存関係のディレクトリ、ビルド出力、シークレット、生成されたアーティファクトはインデックス化しないでください。
- プロジェクト固有のノイズの多いパスには、
--excludeまたはexcludeを優先して使用してください。 - 大規模なリポジトリで
maxFilesを500より大きくする場合は、事前にユーザーに確認してください。
コメント
Markdown 対応