safety-guard

safety-guard skill の概要

safety-guard ができること

safety-guard skill は、破壊的または高リスクなエージェント操作に対する保護レイヤーを追加します。危険なコマンドを止めたいとき、書き込みを特定ディレクトリに限定したいとき、あるいは本番環境・デプロイ先・アクティブデータを壊す可能性をできるだけ下げて自律エージェントを動かしたいときに特に有効です。

こんな用途に最適

ライブシステムを運用している、コーディングエージェントをフルオートで使っている、あるいは移行・インフラ変更・リリース作業を定期的に行っているなら、safety-guard を入れる価値があります。safety-guard skill は、単に「注意する」ではなく、「安全でない操作を実行しにくくする」ことが本質のときに向いています。

なぜ重要なのか

主な価値はワークフローの制御にあります。強制 push、hard reset、破壊的な削除、大規模なシステムクリーンアップのような危険なコマンドをブロックしつつ、編集先を 1 つのパスに固定することもできます。そのため、モデルに広い repo アクセスを与えつつ、実際には狭い範囲だけを変更させたい safety-guard for Access Control では特に役立ちます。

safety-guard skill の使い方

インストールしてソースを確認する

repo にある safety-guard install コマンドを使います:
npx skills add affaan-m/everything-claude-code --skill safety-guard

まずは skills/safety-guard/SKILL.md を開いてください。最短で把握したいなら、先にモード定義を読み、そのあと同じファイル内のリンクされた実装ノートを確認すると効率的です。

ざっくりした目的を実用的なプロンプトにする

safety-guard usage のパターンは、作業内容・リスクレベル・書き込み境界をまとめて指定すると最も機能します。よい入力では、対象領域と欲しいガードレールを明確にします:

• “Update the billing API, but only write inside src/api/ and block destructive commands.”
• “Run in guarded mode while I review changes before any publish or deploy.”
• “Protect production migration work and ask before any command that can delete or reset state.”

動作を変える部分を読む

実運用で役立つ safety-guard guide としては、モードの説明と unlock フローに注目してください。repo 内で本当に意味があるのは、3 つの保護モード、監視するコマンド、そして正確な freeze 構文です。これらが、あなたの環境でその skill が実際に強制力を持てるかどうかを左右します。

結果を改善しやすいワークフロー

危険なコマンドへの確認を主に求めるなら careful モードを使います。書き込み範囲の制限が必要なら freeze モードを使います。両方のリスクがあるなら、ガードを組み合わせたモードを使います。タスクが狭いなら許可するディレクトリを明示し、運用系の作業なら確認を発生させたい具体的なコマンドや操作を指定してください。

safety-guard skill の FAQ

safety-guard は本番作業専用ですか？

いいえ。最も効果を発揮するのは本番ですが、ステージング、共有 repo、ローカルの自律実行でも役立ちます。誤って削除・reset・publish してしまうだけでもコストが高い場面なら有効です。

通常のプロンプトと何が違いますか？

通常のプロンプトは、モデルが注意深さを覚えていることに依存します。safety-guard skill は、その注意を繰り返し使える制御パターンに変えます。危険なコマンドを監視し、許可されたツリー外への書き込みを止め、境界を明確にします。

safety-guard は初心者向きですか？

はい。目的がシンプルで、エージェントに編集させながら repo を保護したいだけなら使いやすいです。初心者がまず理解すべきなのは、確認ベースの保護と、ディレクトリベースの書き込み制限の違いです。

使わないほうがよいのはどんなときですか？

safety-guard は、コードレビュー、バックアップ、環境権限の代わりにはなりません。あくまでガードレールであって、復旧計画ではありません。広い範囲の制限なしリファクタリングが必要な作業では、freeze モードは窮屈すぎる場合があります。

safety-guard skill を改善するには

skill の境界をもっと明確にする

最も効果が大きい改善は、スコープをはっきり書くことです。「安全に」ではなく、何を守るのか、何を編集してよいのか、何を読むだけにすべきなのかを指定してください。入力が具体的なほど、誤ブロックは減り、やり取りも少なくなります。

想定している危険操作を明示する

ワークフローに deploy、publish、DB 変更、クリーンアップコマンドが含まれるなら、最初から伝えてください。safety-guard skill は、確認を優先するべきか、書き込み固定を優先するべきか、その両方かを把握できるほど調整しやすくなります。

よくある失敗パターンを確認する

典型的な失敗は、freeze の範囲が広すぎて正当な編集まで止めてしまうことです。もう 1 つは、タスクの指定が曖昧で、エージェントがコマンドの可否を判断しきれないことです。最初の結果が厳しすぎるなら、ガード対象のパスを狭めてください。逆に緩すぎるなら、コマンド制約とパス制約を明示的に追加してください。

1 回目の実行後に調整する

最初の実行後は、何が変更されたかだけでなく、エージェントが実際に何をしようとしたかを見て調整します。危険なコマンドを試したなら、usage 指示の中でブロック対象パターンを広げます。想定外の範囲まで動いたなら、許可ディレクトリをさらに絞ってください。