npx -y cc-safety-net@latest install --amp を実行します。CC Safety Net は、Amp がアカウントごとにホストする Amp Personal Plugins リポジトリにプラグインとして公開されます。以降は、Amp Orbs 上のスレッドも含め、そのアカウントのすべての Amp セッションがこのプラグインを読み込みます。アカウントにサインイン済みの amp CLI が必要です。インストール後は、Amp を再起動するか plugins: reload を実行してください。
Amp Code に CC Safety Net をインストールする
1
amp CLI にサインインする
amp CLI をインストールし、amp login でサインインします。どちらかが欠けているとインストールは停止し、amp login を案内します。2
インストーラーを実行する
3
Amp を再読み込みする
Amp を再起動するか
plugins: reload を実行して、プラグインを読み込みます。4
プラグインが有効か確認する
update を実行します。amp plugins list にはプラグインのバージョンが表示されないため、doctor が Amp Code のバージョンのずれを報告することはありません。
Amp Code のインストールで変わること
インストールはcc-safety-net/index.ts を Personal Plugins リポジトリにコミットしてプッシュします。Amp はこのファイルをプラグインとして読み込みます。
ローカルのコピーがあると Personal Plugins のプラグインが隠れてしまうため、以前のリリースが残した管理対象のコピーもインストール時に削除します。
- Personal Plugins リポジトリのルートにある
cc-safety-net.ts ~/.config/amp/plugins/cc-safety-net.ts~/.config/amp/plugins/cc-safety-net/（管理対象のindex.tsだけを含む場合）
Amp Code のポリシースナップショット
インストール時には、ユーザーのポリシーファイルのスナップショットを、公開するプラグインに埋め込みます。ポリシーを編集したら、install --amp か update を再実行して変更を公開してください。
- スナップショットが適用されるのは、Orb の空のホームディレクトリのように、ポリシーファイルがないマシンだけです。
- マシン上にポリシーファイルがあれば、内容が不正であっても、常にスナップショットより優先されます。
- ポリシーファイルが存在しない、またはパースできない場合は、スナップショットなしでプラグインを公開します。
- スナップショットには、監査ログの保持期間、ユーザーのルールブック、プロジェクトスコープのポリシーは含まれません。
Amp Code でチェックが失敗したときの動作
呼び出しのチェック中に CC Safety Net でエラーが起きた場合、その呼び出しは拒否されます。プラグインがクラッシュしたり、応答しなくなったり、読み込みに失敗したりしたときに Amp がどう動作するかは、Amp のドキュメントに記載がありません。プラグインが読み込まれなかったセッションは保護されていないものとみなし、amp plugins list で確認してください。
Amp Code での保護範囲の制限
同じtool.call イベントを購読する複数のプラグインがどの順番で動くかを、Amp は定めていません。CC Safety Net がチェックするのは、受け取った時点の入力です。CC Safety Net が許可した後で別のプラグインが入力を書き換えた場合、書き換え後の入力はチェックできません。
Amp Code から CC Safety Net をアンインストールする
cc-safety-net/index.ts を削除し、Amp Code のインストールで変わることに挙げた管理対象のコピーも削除します。cc-safety-net ディレクトリ内のそれ以外のファイルや、CC Safety Net が管理していないコピーは残ります。アンインストール後は、Amp を再起動するか plugins: reload を実行してください。
Amp Code のトラブルシューティング
amp plugins list を実行し、cc-safety-net (User Plugins) の行の状態が active になっているか確認します。それ以外の状態の場合、doctor は次のように表示します。
plugins: reload を実行するか、install --amp を再実行してください。Amp はプラグインを起動時に読み込むため、変更のたびに Amp を再起動するか再読み込みが必要です。