sync-agent-setups

エージェント設定の同期

Claude Code のみを信頼できる唯一の情報源とします。このワークフローでは、検出された Claude 以外のすべてのエージェントを一覧表示しますが、今回の実行中にユーザーが確認した対象にのみ書き込みます。自動では開始されません。

1. ソースと対象のインベントリを作成する

固定パスを前提とせず、現在のマシン上で Claude が使用中のユーザーレベルの設定を見つけます。ユーザーが作成した動作設定のみを一覧表示します。

• グローバルルール；
• スキル；
• カスタムのスラッシュワークフロー；
• フック；および
• 秘密情報を含まない動作設定。

認証情報、会話履歴、キャッシュ、テレメトリ、生成されたランタイム状態、プラットフォーム管理のコンテンツは除外します。インストール済みの Claude 以外のエージェントをすべて検出し、対応する設定箇所を読み取り専用で確認します。推測はせず、利用できない箇所や曖昧な箇所を記録します。

Claude から見える各ソースについて、シンボリックリンクをたどって解決し、チェックサムを計算します。ターゲットの現在のパス、ファイルの種類、リンク先、チェックサムは、下流の差分を Claude にさかのぼって反映することなく読み取ります。

ゲート。 各ソースと検出された各ターゲットに、安定したパス、所有者の分類、明示的な対象範囲内または除外の理由が設定されていること。

2. ドライラン用マニフェストを作成する

${CLAUDE_SKILL_DIR}/references/manifest.md に従って、対象範囲内のすべてのペアを分類します。今すぐ読み込んでください。分類表、適応内容のステージングルール、バックアップパスの解決方法、マニフェストテンプレートが記載されています。すべての項目にステータスが1つだけ設定され、すべての適応プレビューに最終バイト列とその意味上の差分が示されるまで終了しないでください。

3. 書き込み対象を確認する

プレビューを提示して、対象エージェントを選択または確認するようユーザーに求めます。検出されたからといって、書き込みが許可されたことにはなりません。確認の対象となるのは、現在のマニフェストに示された名前付きのターゲット、ready の項目 ID、バックアップパス、正確なコピーに使うリンク先、ステージング済みの適応パス、チェックサム、意図するモード、意味上の差分、提案されたアクションのみです。

確認後に再度インベントリを作成し、バックアップパスを再解決して、ステージング済みのすべての適応を再ハッシュします。ソースのチェックサム、ターゲットの状態、分類、パス、選択されたターゲット、解決済みバックアップパス、ステージング済みのバイト列、ステージング済みのチェックサム、または意図するモードに変更があった場合、その項目は無効となり、プレビューに戻します。確認済みの ready 項目は pending に変更し、blocked、preserved-unsupported、preserved-orphaned の各行はすべて台帳に残します。

ゲート。 すべての pending 項目が明示的に確認済みのターゲットに属し、プレビューとの一致が維持されていること。また、準備完了ではないすべての項目が、ステータスと理由を保ったまま変更バッチの対象外であること。

4. 事前確認を行い、バックアップを作成する

最初のバックアップまたはターゲットへの書き込みの直前に、選択された pending 項目のみを対象として preflight-mutations を呼び出します。対象エージェント、ソースとターゲットのパス、現在のチェックサムとリンク先、ステージング済みの適応パス、チェックサム、意図するモード、意味上の差分、確認元、共有シンボリックリンクのリスク、解決済みのタイムスタンプ付きバックアップパス、無効化条件、項目ごとの復旧方法、書き込み後の読み戻しを含めます。参照用として台帳全体を指定しますが、blocked、preserved-unsupported、preserved-orphaned の項目を、変更カードのターゲットまたはバッチ項目に含めないでください。この独立した事前確認の結果、ガードが変更されていない状態で変更バッチが ready になった場合にのみ続行します。

ターゲットを変更する前に、記録された解決済みの物理パスに、確認済みのタイムスタンプ付きバックアップを作成します。影響を受けるパスごとに、以下を保持します。

• 元のパスと、そのパスが存在しなかったのか、ファイル、ディレクトリ、シンボリックリンクのいずれだったのか；
• シンボリックリンクをたどらずに、リンクのテキスト；
• 解決済みのパスと、存在する場合はチェックサム；および
• 以前のターゲット状態を復元するのに十分な内容と権限。

各項目 ID を復旧アクションに対応付けるバックアップマニフェストを作成します。最初のターゲット変更の前に、バックアップのインベントリとチェックサムを検証します。

ゲート。 すべての保留中のターゲットパスに、保持されたリンクメタデータと解決済みコンテンツの証跡を含む、検証済みの復旧記録があること。

5. 確認済みの項目を適用する

各項目を適用し、${CLAUDE_SKILL_DIR}/references/apply-verify.md に従って各対象を検証します。今すぐ読み込んでください。このファイルには、書き込み保護、種類ごとの適用ルール、復元手順、対象ごとの検証が記載されています。試行したすべての項目の読み戻し状態が確認でき、変更していないものがすべてプリフライト前とバイト単位およびリンク単位で同一になるまで終了しないでください。

完了です。 検出したすべての対象とソース成果物が記録され、確認済みの対象のみが変更され、変更したすべてのパスが復元可能であり、各対象のパリティに関する主張は、最も弱い受け入れ基準に合わせて制限されています。