update-aegis

Aegis を更新する

現在の AI コーディングホストにインストールされている Aegis Method Pack を更新します。

このスキルはホストの保守を行います。ユーザーから Aegis の更新を依頼されたという理由だけで、対象プロジェクトを編集しないでください。

デフォルトの動作

• aegis:update は、現在のホストに登録されている Aegis インストールを更新します。
• 登録済みのすべてのホストを更新するには、明示的に --all を指定する必要があります。
• 複数のホストが登録されていて、現在のホストを特定できない場合は、更新前に具体的な質問を1つしてください。
• インストール済みの Method Pack のルートが別のパスにある場合、開発用チェックアウトは更新しないでください。
• バックグラウンドで自動更新を行わないでください。ローカルレジストリに updateMode を記録することはできますが、このスキルが行うのはユーザーが明示的に開始した更新のみです。

まず証拠を確認する

インストール済みの Method Pack のルートから、ホストスコープのレジストリを確認します。

python scripts/aegis-update.py status --json

レジストリがない場合は、更新前に現在のホストを登録してください。推測ではなく、ホストのインストールガイドと実際の検出パスを使用します。

~/.config/aegis/config.toml ですでに method_pack_root が宣言されている場合、ホストを追加登録する際には、その正規ルートを優先してください。ホスト固有の検出パス、コピーされたスキルディレクトリ、プラグインキャッシュ、アダプターのペイロードは、同じ Aegis 本体を参照する生成済み／ホスト管理対象のビューとして扱い、編集可能な別個のチェックアウトとは見なさないでください。

Codex の例：

python scripts/aegis-update.py register \
  --host codex \
  --sync-mode junction \
  --discovery-root ~/.agents/skills/aegis \
  --reload-hint "restart Codex"

コピー方式を使用するホストの例：

python scripts/aegis-update.py register \
  --host codebuddy \
  --sync-mode copy-skills \
  --discovery-root ~/.codebuddy/skills \
  --reload-hint "restart CodeBuddy"

コピーの同期には、インストールレジストリのスコープ付きファイル一覧を使用します。関係のないファイルとローカル編集を保持し、ビューを変更する前に書き込みの競合があれば停止します。内容が同一の古いコピーは登録できます。内容が異なるコピーは、調整するか、別の検出ルートを指定する必要があります。所有者が不明な古いコピーは保持します。名前やプレフィックスだけでは所有権を証明できません。検証を通すためにそれらを削除しないでください。 Unicode 正規化／大文字小文字の折りたたみで名前が衝突するソースは、移植性を確保するため拒否されます。内容が変更された大文字小文字のみの名前変更では、競合するファイルを検出ルート外のバックアップに移動するか、別のルートを選ぶ必要がある場合があります。調整時には既存ファイルを保持してください。

プレフィックス付きの直下の子ディレクトリを使うホストの例：

python scripts/aegis-update.py register \
  --host copilot \
  --sync-mode junction \
  --discovery-shape direct-child \
  --discovery-root <target-repo>/.github/skills \
  --discovery-name-prefix aegis- \
  --reload-hint "restart Copilot session or reopen the repository"

Kimi Code CLI の自動インストールはプラグイン管理対象です。Aegis のアップデーターを使って Kimi の管理対象プラグインのコピーを更新しないでください。Kimi では、ネイティブの更新または再インストールの手順を実行し、選択した管理対象プラグインを確認してから再読み込みします。

/plugins install https://github.com/GanyuanRan/Aegis
/plugins info aegis
/reload

管理対象コピーの置き換えに確認または削除が必要な場合は、プラグインマネージャーに表示される正確なプロンプトに従ってください。その後、/plugins info aegis から管理対象ルートを特定し、次を実行します。

cd <aegis-method-pack-root>
python scripts/aegis-doctor.py --json --host-profile kimi-code-auto

Kimi Code CLI の明示的な互換モードでのインストールの例：

python scripts/aegis-update.py register \
  --host kimi-code \
  --sync-mode junction \
  --reload-hint "restart Kimi Code CLI"

kimi、kimi-code、kimi-code-cli で --discovery-root が省略された場合、アップデーターは $KIMI_CODE_HOME/skills を使用します。KIMI_CODE_HOME が設定されていない場合は、~/.kimi-code/skills を使用します。このアップデーターのパスを使うのは、Aegis Kimi プラグインが無効化またはアンインストールされており、ユーザーが明示的な互換モードを選択した場合に限ります。

プラグイン管理対象のホストは登録できますが、更新パスはホストのプラグインマネージャーが管理しているとアップデーターが通知します。

python scripts/aegis-update.py register \
  --host opencode \
  --sync-mode plugin-managed \
  --reload-hint "restart OpenCode"

更新コマンド

現在のホスト、または明示的に選択したホスト：

python scripts/aegis-update.py update --host <host> --json

ユーザーが全ホストの更新を明示的に依頼した場合に限り、登録済みのすべてのホスト：

python scripts/aegis-update.py update --all --json

ファイルに触れずにプレビューする場合：

python scripts/aegis-update.py update --host <host> --dry-run --json

インストール済みのチェックアウトにローカルの変更がある場合は、それらを上書きしないでください。ユーザーに対処方法を尋ねるか、明示的な許可を得たうえで次のコマンドを使用し、変更を保持してください。

python scripts/aegis-update.py update --host <host> --stash --json

完了の証拠

アップデーターが選択されたホストを報告し、更新後の doctor 検証が成功した場合にのみ、更新が完了したと見なします。リンクベースの検出ルート（junction、symlink、または repo-only）の場合、アップデーターは discoveryRoot を aegis-doctor.py --discovery-root に渡します。登録済みの直接の子ビューで discoveryNamePrefix が宣言されている場合は、アップデーターは --discovery-name-prefix も渡します。コピー方式のホストの場合は、コピー手順の後にコピーされた Aegis スキルディレクトリが存在することを確認し、その後、メソッドパックのルートに対して doctor を実行します。

複数の登録済みホストが同じ methodPackRoot を共有している場合、アップデーターはメソッドパックのチェックアウト更新を 1 回だけ実行し、その後、各ホストの公開パスまたは検証パスを個別に更新するようになりました。

次の内容を報告してください。

• 選択されたホスト／インストール ID
• 可能な場合は更新前と更新後のコミット
• インストールが更新されたか、すでに最新だったか
• 使用した同期モード
• doctor の検証結果
• 再起動または再読み込みのヒント

アップデーターが plugin-managed ホストをスキップした場合は、ホストのプラグインマネージャーが更新パスを管理していることを明記し、再読み込みまたは再インストールのヒントを提示してください。

Kimi の自動インストールの場合、完了には /plugins info aegis、/reload または /new、kimi-code-auto doctor プロファイル、および docs/README.kimi-code.md に記載されているホストネイティブの自動エントリーチェックも必要です。ファイルの検出や汎用 doctor の結果だけでは不十分です。