skip to content
日替わり OSS
Table of Contents

リポジトリ

dcg (Destructive Command Guard) とは

近年、開発現場ではコーディングアシスタントの導入が急速に進んでいます。しかし、これらの強力なツールが時として意図せず危険なコマンドを実行し、貴重なコードや開発環境を破壊してしまうリスクが顕在化しています。destructive_command_guard、通称 dcg は、このような破壊的なコマンドの実行を未然に防ぎ、開発者の安全と生産性を守るために設計された高性能なコマンドガードツールです。Rustで書かれており、その高速性と堅牢性で、多くのコーディングエージェントと連携し、開発ワークフローに不可視の安全網を提供します。

開発現場が抱える課題と dcg の役割

GitHub Copilot、Google Gemini、Claude Code、Cursor IDEなど、高度な言語モデルを基盤とするコーディングエージェントは、コード生成、デバッグ支援、リファクタリング提案など、開発者の生産性を飛躍的に向上させています。一方で、これらのエージェントは、ユーザーの意図を完全に理解できない場合や、誤ったコンテキストで指示を解釈した場合に、予期せぬ破壊的コマンドを提案したり、実行したりする危険性をはらんでいます。

例えば、以下のようなシナリオが考えられます。

  • Git操作の誤り: 「最新の状態に戻して」と指示した際に git reset --hard HEAD~5 のようなコマンドが提案され、未コミットの変更がすべて失われる。
  • ファイル操作の誤り: 「不要なファイルを削除して」と指示した際に rm -rf ./src のようなコマンドが実行され、プロジェクトのソースコードが削除される。
  • データベース操作の誤り: データベース関連の指示中に DROP TABLE users のようなコマンドが誤って実行され、本番環境のデータが失われる。
  • インフラ操作の誤り: クラウド環境の操作中に aws ec2 terminate-instances など、致命的なリソース削除コマンドが実行される。

これらの誤操作は、数時間の作業を一瞬で水の泡にするだけでなく、プロジェクト全体に深刻な損害を与える可能性があります。dcg は、こうしたリスクから開発者を守るための最終防衛線として機能します。エージェントが生成したコマンドが実行される前に dcg がそれを捕捉・分析し、危険性があると判断した場合は実行をブロック。開発者にはその理由と安全な代替手段を提示することで、意図しない破壊を防ぎます。

dcg の主な機能と利点

dcg は、単にコマンドをブロックするだけでなく、開発者が安心してエージェントを活用できるよう、多岐にわたる高度な機能を提供します。

1. ゼロコンフィグで即座に保護を開始

dcg はインストール後、すぐに危険なGitコマンドや基本的なファイルシステム操作をブロックするよう設定されています。特別な設定なしに、一般的な開発環境での事故を防ぐための基本的な安全網を提供します。

2. 50以上の豊富なセキュリティパック

データベース (postgresql, mysql)、コンテナ (docker, kubernetes)、クラウドサービス (aws, gcp, azure)、インフラ管理 (terraform) など、特定の技術スタックに特化した50以上のルールパックが用意されています。これらのパックを有効化することで、より専門的で破壊的なコマンドに対しても保護を拡張できます。

# ~/.config/dcg/config.toml の設定例
[packs]
enabled = [
    "database.postgresql",    # DROP TABLE, TRUNCATE などをブロック
    "kubernetes.kubectl",     # kubectl delete namespace などをブロック
    "cloud.aws",              # aws ec2 terminate-instances などをブロック
]

これにより、特定の環境におけるリスクをピンポイントで軽減できます。

3. サブミリ秒の超高速動作

Rustで実装されているため、dcg は非常に高速に動作します。SIMDアクセラレーションによるフィルタリング機構により、コマンド実行前のチェックがサブミリ秒で完了するため、開発ワークフローの遅延をほとんど感じさせません。

4. 複雑なコマンド構造への対応

python -c "os.remove(...)" のようなインラインスクリプトや、cat <<EOF | bash のようなヒアドキュメントを使った複雑なシェルコマンド内でも、破壊的なパターンを正確に検出します。これは、単一のキーワードマッチングでは見落とされがちな巧妙な攻撃や誤操作にも対応できることを意味します。

5. スマートなコンテキスト認識

dcg はコマンドのコンテキストを考慮し、賢明な判断を下します。例えば、grep "rm -rf" のように、コマンド自体をデータとして扱う場合はブロックせず、実際に rm -rf / のように実行意図のあるコマンドだけをブロックします。これにより、誤検知による不必要なワークフローの中断を防ぎます。

6. ユーザーフレンドリーな出力

コマンドがブロックされた際には、その理由、該当コマンド、そして安全な代替案やヒントを、人間にとって分かりやすいリッチなターミナル出力で提示します。これにより、開発者は何が起こったのか、どうすれば良いのかを迅速に理解できます。

7. エージェント向けに最適化された連携

GitHub Copilot CLIやGemini CLIなどのエージェントは、dcg からの機械可読なJSON出力を stdout で受け取り、開発者向けのメッセージは stderr で表示するといった工夫がされています。これにより、エージェントは dcg のブロック情報を正しく解釈し、同時に開発者には詳細な情報が提供されます。

8. CI/CD 環境での活用

dcg は scan モードも提供しており、GitのプリコミットフックやCI/CDパイプラインに組み込むことで、コードレビューの段階で危険なコマンドの存在を検出できます。これにより、潜在的なリスクを早期に発見し、開発ライフサイクルのより早い段階で修正することが可能になります。

9. エージェントごとの柔軟な設定

dcg は、エージェントの種類に応じて異なる設定を適用できます。例えば、特定の信頼度の高いエージェントには許可リストを広く設定し、新規または信頼度の低いエージェントには追加のルールパックを適用し、許可リストを無効にする、といった細やかな制御が可能です。これにより、エージェントの特性に応じた最適な保護レベルを実現できます。

# エージェントごとの設定例
[agents.claude-code]
trust_level = "high" # 信頼レベルを高く設定（ログ用）
additional_allowlist = ["npm run build"] # 特定のコマンドを許可
disabled_packs = ["kubernetes"] # 特定のパックを無効化


[agents.unknown]
trust_level = "low" # 未知のエージェントは信頼レベルを低く設定
extra_packs = ["paranoid"] # 追加の厳格なパックを有効化
disabled_allowlist = true # 許可リストを無効化

導入方法

dcg の導入は非常に簡単です。提供されている install.sh スクリプト（Linux/macOS/WSL向け）や install.ps1 スクリプト（Windowsネイティブ向け）を実行するだけで、自動的にプラットフォームを検出し、適切なバイナリのダウンロードと主要なエージェントフックの設定が行われます。 詳しいインストール手順やプラットフォーム固有の注意点については、公式のREADME を参照してください。

まとめ

コーディングエージェントは現代の開発に不可欠な存在となりつつありますが、それに伴う新たなリスク、特に破壊的コマンドの誤実行は避けて通れない課題です。dcg (Destructive Command Guard) は、この課題に対する堅牢で高性能なソリューションを提供します。Rustによる実装で高速性を確保し、豊富なルールパックとスマートなコンテキスト認識で、幅広い種類の危険なコマンドから開発環境を保護します。

開発者は dcg を導入することで、AIアシスタントの強力な恩恵を受けつつも、予期せぬ事故の恐怖から解放され、より安心して創造的な作業に集中できるようになります。開発者の安全と生産性向上を両立させる dcg は、今後の高度な言語モデルを活用した開発ワークフローにおいて、必須のガードレールとなるでしょう。