init-rulebook

Init Rulebook

ユーザーが ~/.agents/AGENTS.md に独自のエージェント指示を保持し、必要に応じてルールをリンクできるよう支援します。既存のルールブックを採用するか、セットアップ時に作成します。プロジェクトフォルダーなど、別のフォルダーを選択することもできます。スキルの更新後も個人設定が保持されるよう、ルールはこのスキルの外部に保管してください。

既定のパスは、このスキルの規約です。各ホストには、このパスを指す起動時の指示が必要です。ホストのセットアップを参照してください。ホストの指示の階層と、ルールブックで宣言された適用範囲を維持してください。

モード

モードが指定されている場合は、そのモードを使用します。指定されていない場合、セッション開始、圧縮後の復旧、または明示的な再読み込み要求では load と推定し、一致する要求がある場合に限り、別のモードを推定します。セットアップまたはメンテナンスを行う際は、推定したモードを明示してください。これらはスキルのモードであり、シェル CLI ではありません。

モード	使用する場面	完了条件
init-rulebook: setup	既定のルールブックを採用または作成する場合。任意のカスタムフォルダーも指定できます	起動時のポインターが設定され、新しいセッションでの検出が確認されている
init-rulebook: load	セッションを開始する場合、圧縮後に再読み込みする場合、またはルールを再読み込みする場合	インデックスと、現在適用されるすべてのルールを最後まで読み込んでいる
init-rulebook: fine-tune	既存のインデックス、グループ分け、トリガー、またはルールの文言を改善する場合	合意した編集内容と、代表的な読み込みシナリオを検証している
init-rulebook: link-dot-files	dotfiles に保存されたルールブックをホストまたは安定したユーザーパスに接続する場合	リンクまたは直接ポインターが、他のファイルを置き換えることなく、目的のインデックスを指している
init-rulebook: update	インストール済みのスキルまたは Git 管理のルールブックを更新する場合	要求されたソースが最新で、ローカルの変更が保持され、status に合格している
init-rulebook: status	検出、壊れたリンク、不足しているルール、または読み込み範囲を診断する場合	インデックスのパス、一覧、選択されたルール、未解決のエラーが報告されている

setup、fine-tune、link-dot-files、または update では、オンボーディングとメンテナンスを読んでください。ユーザーがルールセットのサンプルを求めている場合に限り、公開ルールブックの例を読んでください。セッション開始と再読み込みでは、どちらのリファレンスも必要ありません。

インデックスを解決する

1. 現在のリクエストで明示されたパスがあればそれを使用し、なければホストの起動時ポインターを使用します。AGENTS.md のパス、またはそのファイルを含むフォルダーを指定できます。相対パスのポインターは、それを宣言しているファイルを基準に解決し、直接リクエストの相対パスは作業ディレクトリを基準に解決します。明示的なリクエストでは、この呼び出しで使用するパスが選択されますが、永続ポインターは書き換えません。
2. それ以外の場合は ~/.agents/AGENTS.md を使用します。ホームディレクトリのパスを展開し、シンボリックリンクを解決して、読み取り可能か確認します。load の実行中にインデックスを作成してはいけません。
3. インデックスが見つからない場合、相対パスの基準が曖昧な場合、または明示的な選択がない状態で永続ポインターが競合している場合は、問題を報告して目的のパスを尋ねます。任意のフォルダーを検索したり、リポジトリの AGENTS.md で代用したりしてはいけません。

選択したパスはこのセッション中保持し、圧縮後またはポインターの変更後に再解決してください。ホストの優先順位に従って、プロジェクトの指示を選択したルールブックと併用してください。

読み込みと再読み込み

まずインデックス全体を読みます。このスキルの見出し例を別のユーザーのルールに当てはめるのではなく、インデックスに記載された構成に従います。

インベントリの確認では、パス一覧とファイルシステムのメタデータを使用して、存在、読み取り可能性、同一性を確認します。ルールの内容を開く前に、インデックスから該当するルールを選択します。インベントリを検証するためだけに、後回しにするルールの内容を読んではいけません。この読み取り境界は、statusとセットアップ時のステータス確認にも適用されます。

1. インデックスでディレクトリの列挙や、見つかったファイルとリンクの照合が指示されている場合は、そのインベントリを実施します。「網羅的なインベントリ」という言葉が必須というわけではありません。欠落、孤立、重複、または読み取り不能なファイルを報告し、黙って除外してはいけません。インデックスに記載されたパスを使用し、そのパス表記を変更しないでください。インデックスに~/.agents/rules/*.mdと記載されている場合、対象ツリーは~/.agentsです。ツリーの同一性は、ホームパスや相対パスを展開し、シンボリックリンクを解決した後の正規ディレクトリパスで比較します。文字どおりのパス表記で比較してはいけません。たとえば、~/.agents -> ~/.dotfiles/agentsの場合、この2つのツリーパスは同等です。書かれたとおりの~/.agents/rules/*.mdパスを通じて列挙し、書き換えてはいけません。不一致を報告するのは、解決後のインベントリツリーが、解決後に選択されたインデックスのツリーと異なる場合に限ります。代替のrules/ディレクトリやリポジトリのAGENTS.mdをスキャンしてはいけません。いずれかのパスを解決または読み取りできない場合は、同一または不一致だと決めつけず、そのエラーを報告します。インデックスで完全なインベントリが求められていない場合は、読み込み対象として選択した、参照されているすべてのルールパスを検証し、無関係なファイルをエラーとして扱ってはいけません。
2. インデックス独自の適用可否ラベルを使用します。常時適用グループのルールはすべて読み込み、現在のタスク、環境、または予定しているツールに記載上のトリガーが一致する条件付きルールも読み込みます。条件付きトリガーごとに、肯定的な根拠が必要です。操作名から関連する活動を推測してはいけません。たとえば、公開するだけでは本番環境での運用が確立したことにはなりません。インデックスで「常時適用」「有効化」「操作時のみ」などの見出しが定義されている場合は、それらの見出しに従います。別のインデックスでは、異なるラベルが使われている場合があります。インデックスの順序を維持します。インデックスにグループ分けがない場合は、その読み込み手順に従います。ルールブックが単一ファイルの場合は、全文を読みます。
3. 操作時のみ適用されるルールとそのトリガーを記録します。ただし、該当する操作の直前まで、それぞれのルールを読み込んではいけません。より広い依頼に今後の操作が記載されていても、そのゲートは開きません。
4. 選択したファイルをすべて最後まで読み込んだことを確認します。ルールの読み込みと適用は別です。インデックスとルールに定められた適用範囲および指示の優先順位を守ります。読み込みを完了したと主張するのではなく、インベントリまたは読み取りを妨げるエラーを報告します。

セッション開始時とコンテキスト圧縮後に、この読み込みを再度実行します。圧縮前に記憶したファイル内容は古いものとして扱います。ユーザーのタスクが変わったら、条件付きの見出しを再評価し、新たに該当する操作ゲートを直前に開きます。ユーザーがステータスを求めている場合、注意を要するエラーがある場合、またはホストがスキル使用の通知を要求する場合を除き、読み込みについては何も通知しません。

ステータス

loadと同じ適用可否の選択と内容の読み取り境界を適用し、選択したインデックス、ポインターの参照元、インベントリエラー、選択したルールと保留中のルールの件数、ならびに新規セッションでの検出を実際にテストしたかどうかを報告します。statusはファイルを変更せずに読み取ります。

動作評価

**作成者／レビュアーのみ：**このスキルの評価にはシナリオカタログを使用します。通常のルールブック利用時はスキップしてください。各ケースを新しい一時ディレクトリに用意し、アサーションと振り分けラベルを伏せたうえで、評価用にファイルの読み取りと変更を記録します。カタログでは、6つすべてのモード、読み込み失敗、操作ゲート、シミュレーションされたコンテキスト圧縮を扱います。期待されるアサーションは、実行に合格した証拠ではありません。仮想ホームおよびホスト用のフィクスチャによって、実際のユーザー環境を変更してはいけません。