bookmarker について
bookmarkerは、タスクを続ける前にブックマークから適切な作業ディレクトリを選ぶスキルです。候補を関連性順に評価し、判断が難しい場合は選択を求めます。
主な機能
- 01現在のディレクトリの適合性確認
- 02指定ブックマークの検索
- 03代替候補の関連性順評価
- 04候補ディレクトリの調査
- 05選択したパスでの作業継続
活用シーン
- 01ブックマークからプロジェクトディレクトリを選択
- 02複数のリポジトリ候補の判別
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ primeapple/ bookmarker --skill bookmarkerインストール後、Claude Code で/bookmarkerを入力して読み込まれたか確認します。
詳細
Bookmarker
このスキルは、場所が厳密に指定されていない場合にのみ使用してください。まず、現在の作業ディレクトリがユーザーの依頼に適しているか判断します。適している場合は、そのディレクトリにとどまります。
別の場所が必要な場合:
-
LOCATIONにユーザーが指定した場所を設定します。bm get LOCATIONを実行します。 -
bm get LOCATIONがパスをちょうど1つ返した場合は、その結果を使用します。 -
それ以外の場合は、
bm list --porcelainを実行します。各レコードはbookmark<TAB>pathです。区切り文字はリテラルのタブです。パスにスペースが含まれていても正しく扱えるよう、ブックマークとパスを別々のフィールドとして解析します。 -
次の順序で代替候補を評価します。
- ブックマーク名が完全一致するもの
- パスのベース名が完全一致するもの
LOCATIONがパスの構成要素に含まれるもの- 文脈上関連するブックマーク名
パスの構成要素に一致するものより、ベース名に一致するものを優先します。たとえば、
fooでは/Users/toni/src/foo/design-systemではなく/Users/toni/fooを選択します。 関連する名前を選ぶ際は、タスクの意味を考慮します。バックエンド作業では、frontend-for-backendよりbackend-repoのほうが関連性が高くなります。単なる部分一致だけで選ばないでください。 -
1つのパスが明らかに最適な候補であれば、それを選択します。複数のパスが候補として妥当な場合は、それぞれがタスクに関連するか確認します。該当する場合は、ディレクトリ、リポジトリの状態、リモートを確認し、
README.mdまたはAGENTS.mdがあれば読みます。1つの候補が明らかに適切であれば作業を続けます。そうでなければ候補を提示し、ユーザーに選択を求めます。 -
該当する候補がない場合は、試したことをユーザーに伝え、ブックマーク名またはパスを尋ねます。ドライブ全体を検索しないでください。
-
選択したパスから以降の操作をすべて実行します。対応している場合はツールの
cwdを設定します。そうでなければcd -- "$path" && ...を使用します。 -
その場所でユーザーのタスクを続行します。パスを報告するだけにしたり、ユーザーにディレクトリの変更を求めたりしないでください。
完了条件:ユーザーのタスクを、選択した適切なパスから実行します。選択が依然として不明確な場合は、候補を提示してユーザーに選択を求めた時点で停止します。