sjskills

sjskills

sjskills を使用して、プロジェクトでコミットされた sjskills.toml、またはツールに固定されたグローバルベースラインによって選択されたスキルの状態を正確に調整します。このツールは、検証済みの配置、来歴、隔離、復元を管理します。ソースの変更を公開したり、カタログから任意にインストールしたりすることはありません。

厳密な同期の対象は、選択されたグローバルまたはプロジェクトの .agents/skills と .claude/skills のルートのみです。宣言されていないディレクトリは、未知のコピーやローカルで変更されたコピーも含め、復元可能な隔離領域に移動します。組み込みスキル、プラグインキャッシュ、以前の Pi のコピーはこの対象外です。

以前に管理されていた、ローカルで編集された目的のコピーも隔離領域に保持したうえで、検証済みの公開コンテンツに置き換えます。プランでは、これらを理由 local-modification の更新として報告します。これには、同じソースに対する信頼できる来歴と、検証可能な現在のツリーが必要です。未知の目的のコピーがある場合は、引き続き調整がブロックされます。編集済みのバイト列を復元しても、所有権は付与されません。

次の4つの状態は区別してください。

1. ソースリポジトリのローカルカタログは編集できますが、まだ公開されていません。
2. レジストリは、調整で使用できる公開済みのリモートコンテンツを示します。
3. プロジェクトでコミットされた sjskills.toml は、プロジェクトプロファイルと直接宣言を選択します。
4. レジストリは、マシンに依存しない固定のグローバルベースラインを定義します。

PATH 上にある sjskills を優先してください。ツールのソースリポジトリでは、コマンドがインストールされていない場合に bin/sjskills を使用します。ユーザーから依頼されない限り、コマンドをインストールしたり PATH を変更したりしないでください。

ステータスコマンド、鮮度、注意事項、JSON の解釈については、ステータスの確認をお読みください。プロファイルや直接宣言の作成・変更、または認証済みソースの要件の解決については、プロジェクトでの選択をお読みください。ステータスの確認や設定だけでは、調整は許可されません。

リクエストを分類する

• 設定済みの状態を同期する： スキルとの同期または調整を明示的な限定なしに求めるリクエストは、固定のグローバルベースラインと、存在する場合は現在のプロジェクトのコミット済み sjskills.toml の両方を対象とする権限を与えます。プロジェクトのみ、グローバルのみ、マシン、または保持に関する明示的な制限があれば従ってください。プロジェクトマニフェストが存在しない場合は、グローバルベースラインのみを調整し、プロジェクトが未設定であることを報告してください。初期化したり、インストール済みのコピーからプロファイルを推測したりしないでください。
• 説明または調査を行う： 両方のスコープには status、利用可能な選択肢には profiles、選択したスコープをすべて確認するには plan ／ plan --global を使用します。これらの操作では管理対象のルートは保持されますが、想定されるコンテンツを一時的に取得する場合があります。アクションを指定せずに実行した場合は、デフォルトでステータスを確認します。
• プロジェクトを設定する： 管理対象のプロジェクトスキルを採用する、または選択内容を変更するようユーザーが求めた場合は、sjskills.toml を作成または編集します。プロジェクト選択のリファレンスに従い、選択したプロファイル、個別の宣言、またはその両方を使用します。無関係なエントリは保持してください。設定のみでは、適用やグローバル変更の権限は与えられません。
• プロジェクトを調整する： plan を確認し、ユーザーがプロジェクトへのインストール、ブートストラップ、調整、または同期を求めた場合に限り apply を実行してから、再度 plan を実行します。
• プロジェクトの状態を復旧する： ユーザーが指定した正確な隔離 ID のみを復元し、モデル化されたすべての移行先に何も存在しないことを確認してから実行します。
• グローバルの調整または復元： グローバルに変更を加える前に、references/global-rollout.md を読んでください。同期リクエストは調整の権限を与えるため、ハッシュの承認をユーザーに求めず、必要な証拠を自分で準備して確認してください。復元には、隔離対象を特定するリクエストが必要です。

通常の Skills CLI ワークフローを使用して、ソースのスキル名を特定するか、リクエストされたアドホックインストールを実行してください。sjskills で管理されるプロジェクトの場合は、外部スキルを [[direct]] に記録し、sjskills で調整してください。管理対象のルートにある未宣言のアドホックインストールは、隔離候補になります。ローカルカタログの検証と公開は、調整には該当しません。

設定済みの権限を使用する

リクエストが権限を与え、コミット済みマニフェストと固定ベースラインが目標セットを定義します。確認済みのインストール、更新（ローカルで編集された管理対象のコピーの隔離と置き換えを含む）、出所情報の移行、ならびにそのセットの管理対象ルート内にある未宣言のコピーの復元可能な隔離を進めてください。適用前に、ユーザーに次の応答を求めず、確認済みの操作を要約してください。ユーザーが対話型の確認ポイントを求めていない限り、すでに許可された適用には --yes を使用します。フラグや計画の成果物によって権限が生じることはありません。

ローカル編集を有効なまま保つ、または特定のパスを保持するよう明示的に求められた場合は、計画によってそれらが置き換えられる、または隔離されるスコープの処理を停止してください。通常の同期では、置き換え前にローカル編集を隔離して保持する権限がすでに与えられています。上書きフラグや追加の確認は不要です。

「上書きして同期」しても、管理対象外の目標コピー、ソースの不一致、破損した出所情報、安全でない境界、またはマテリアライズの失敗は解決されません。こうした競合がある場合は、該当するスコープの処理を停止し、必要な具体的な解決策を説明してください。計画を通すために、強制的な採用、ルートの手動置き換え、プロファイルの変更、または別のマシンの追加を行わないでください。ユーザーが全か無かの結果を求めていない限り、独立していて妨げられていないスコープは完了させてください。

プロジェクトのワークフロー

1. コマンドとプロジェクトのルートを特定します。sjskills.toml が存在しない場合、ユーザーが導入または初期化を依頼していない限り、停止します。
2. プロファイルを含む新しいマニフェストの場合は、sjskills profiles を実行し、ユーザーが選択したプロファイルを使用して sjskills init <profile> ... を実行してから、依頼された直接宣言を追加します。直接宣言のみの導入、または既存のマニフェストの場合は、プロジェクト選択のリファレンスを使用します。インストール済みのコピーからプロファイルを推測したり、既存のマニフェストを init で上書きしたりしないでください。
3. マニフェストを読み取り、sjskills plan を実行します。インストール、更新、隔離、変更のない配置、手動管理またはワークフロー管理のエントリー、警告、ブロックを要約します。希望状態とのずれや競合と、コマンド、ネットワークリクエスト、マテリアライズの失敗を区別してください。運用上の失敗は有効なプランではありません。
4. local-modification の更新は、現在のツリーが公開済みのツリーと一致していても、記録されたインストール内容とは異なる場合を含め、保持と置換を伴う操作として確認します。管理されていない希望コピー、ソースの不一致、不正な形式または信頼できない来歴、安全でないファイルシステム境界、検証不能な追加項目、マテリアライズの失敗、その他の競合がある場合は、適用前に停止します。
5. 承認済みのプロジェクト調整では、プランの確認を通過した後に sjskills apply --yes を実行します。プレビューで停止する、または対話型の確認を維持するという明示的な依頼がある場合は、それに従います。
6. もう一度 sjskills plan を実行します。変更またはブロックが残っている場合、状態が完全に一致していると主張しないでください。通常の作業サイクルを通じて、報告されたすべての隔離識別子を保持します。

レジストリを参照するソースで意図した内容が変更された場合、調整で使用できるのは公開済みのリモート内容のみです。ローカルのみの変更を適用しないでください。公開が依頼された場合は、検証、レビュー、コミット、公開についてソースリポジトリの手順に従ってください。これらの手順はこのスキルの範囲外です。調整の前にレジストリのソースを特定し、ピン留めされたリモート参照に、意図した各スキルツリーが含まれていることを確認します。レジストリが別の場所を参照している場合、ローカルまたはフィーチャーブランチのコミットだけでは不十分です。

復元

復元は独立した変更として扱います。ユーザーに隔離識別子を指定してもらい、現在の状態を確認し、すべての配置先に何も存在しないことを確認します。次を実行します。

sjskills restore <quarantine-id>

復元を成功させるために、アクティブな配置先を移動、削除、上書きしないでください。内容または来歴が変更されている場合は、両方を保持して競合を報告します。復元しても、不明なコピーまたはローカルで変更されたコピーの所有権は付与されません。編集済みのバックアップを復元すると、新しいインストールの来歴は所有権の記録なしに置き換えられます。その後 sjskills plan を実行します。復元された未宣言のスキルは削除のずれとなり、復元された編集済みの希望スキルは管理対象外の競合となります。

グローバルの境界

グローバル調整では、マシンに依存しない固定のベースラインを使用します。プロファイルはプロジェクトのスキルを選択するものです。グローバルプロファイルを独自に作成したり、ホスト名から推測したり、Pi 固有のコピーを合成したりしないでください。確認の依頼では sjskills plan --global のみを実行します。設定済みの同期は、検証済みの適用を通じて続行します。

--approved-plan フラグと --approved-plan-sha256 フラグは、グローバル適用をエージェントがレビューした証跡に結び付けます。これらのフラグ名は、人間による個別の承認手続きを要求するものではありません。アーティファクトを作成し、すべての操作と警告を確認してダイジェストを計算し、同じ検証済み実行ファイルを適用から最終プランまで使用します。同期の依頼にはこの作業が含まれますが、監査、リポジトリの検証、無関係なセットアップの依頼には含まれません。復元と競合の解決は、設定済みの希望セットを完全に一致させる作業とは別です。

完了

報告内容：

• プロジェクトまたは固定グローバルのスコープ、および作業が読み取り専用だったか、変更を伴ったか；
• 該当する場合は、選択されたプロファイルまたはマニフェストの直接宣言；
• 残っている追加項目、ブロック、およびスコープ外のレガシー状態を含む、計画と最終計画の結果；
• リモートを参照するローカル変更があった場合は、公開済み参照の根拠；
• 保持または復元されたすべての隔離識別子；および
• 明示的な許可待ちの変更。