box について
リポジトリのクローンやローカル検索を行い、結果を報告するスキルです。永続化は依頼時に限り、準備・検索・書き込みの役割を分け、サンドボックスを作業リポジトリの外に保ちます。
主な機能
- 01必要に応じたリポジトリのクローン
- 02既存クローンの一覧表示
- 03根拠付きのローカルファイル検索
- 04スコープ別の委任作業
- 05依頼時の AGENTS.md への永続化
活用シーン
- 01クローンしたリポジトリ内の情報検索
- 02クローン一覧の確認と古い複製の特定
- 03承認済みの調査結果を作業リポジトリの AGENTS.md に保存
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ prathamdby/ skills --skill boxインストール後、Claude Code で/boxを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
REFERENCE.mdreferences/agents-md-template.mdpersist.mdprepare.md詳細
Box
オプションと所有権
デフォルトでは、必要に応じてクローンし、検索して報告します。明示的に依頼された場合のみ永続化します。 「Update」/「pull first」の場合は、先に早送りします。「list」の場合はクローンを報告して終了します。 「Persist」/「add to AGENTS.md」により、検索後の書き込みが有効になります。 「No subagents」/「in this thread」の指定がある場合、または委譲が利用できない場合はDirectを選択します。それ以外はDelegatedを選択します。このモード切り替えは明示的に行い、サイズを基準に判断しないでください。 listとsearchが矛盾する場合、または必要なURLがない場合は処理を中止します。
このスキルの絶対パスのアンカー、sandbox/manifest.json、sandbox/、
および作業リポジトリのAGENTS.mdを特定します。サンドボックスは作業リポジトリの外に配置します。
Directではステージの契約を実行します。DelegatedではPrepare担当の書き込みエージェントを1つ、互いに重複しない範囲を読み取り専用で検索するSearchワーカーを複数、Persist担当の書き込みエージェントを1つ使用します。親はディスパッチと集約のみを行います。
ワーカーが失敗した場合は処理を中止します。ワーカーは委譲できません。
mode | slug/URL/path | prepare | search scopes/evidence | persist | current | terminalを記録します。
1. 検出と準備
単独のlist要求の場合、manifestがない場合は空として扱います。slug、URL、パス、古いクローンを報告して終了します。URLのslugは末尾のセグメントから.gitを除いたものです。名前は大文字と小文字を区別して一致させます。 一致が0件または複数件の場合は、URLが必要です。listの報告を送信するか、対象が確定した時点で完了です。
検索では、絶対パスの入力を指定してreferences/prepare.mdを実行またはディスパッチします。検索を始める前に、検証が完了するまで待ちます。部分的なクローンはmanifestに追加しません。不明なディレクトリは削除しません。クローンのoriginとmanifestが一致した時点で完了です。
2. 検索
重複しないサブツリー/質問を、絶対パスのクローンパスとともに割り当てます。ローカルファイルのみを読み取り専用で検索します。質問がない場合は、README、manifest、レイアウト、エントリーを調べます。 パスと行番号による根拠、または対象範囲を指定した該当なしの報告、その周辺の文脈、および検索対象外を含めるよう求めます。ブリーフにはアンカー、対象の特定情報、ステージ、書き込み境界、入力、出力、ネストした委譲を行わないことを含めます。すべての範囲から根拠が返された時点で完了です。
3. 集約と永続化
重複を除いた引用を添えてテーマ別に回答し、検索していない範囲を明記します。
永続化が依頼され、かつ検索が完了している場合に限り、references/persist.mdを実行またはディスパッチします。書き込み先は作業リポジトリのAGENTS.mdのみです。回答に引用があり、許可されたマーカーブロックが正確に1つ存在する時点で完了です。
再開時はmanifest、クローン、結果、マーカーを確認します。最も早い未完了条件から再開し、不足している検索を再ディスパッチします。対象の特定情報/パス、準備、範囲/該当なし、永続化を報告します。SUCCESS/BLOCKED/NO_MATCHES(すべての範囲が空の場合)。 クローンのコミットやプッシュ、URLに基づく推測、重複する書き込み担当を認めません。