Communityコーディング&開発github.com

jzOcb/config-guard

AIエージェントが設定変更の検証、自動バックアップ、スキーマ検証、自動ロールバックによりOpenClawをクラッシュさせるのを防ぎます。

config-guard とは?

このスキルは、AIエージェントがOpenClawの設定ファイルを変更する際に、致命的なエラーを引き起こすのを防ぐためのツールです。主な機能として、変更前の自動バックアップ、設定値のスキーマ検証、そして問題発生時の自動ロールバックを提供します。これにより、AIエージェントが誤った設定を適用しても、システムの安定性を維持できます。対応プラットフォームはClaude CodeやCursorなどの一般的なAIエージェントツールです。SKILL.mdに基づき、設定ファイルの操作前にバックアップを作成し、変更内容をスキーマと照合してから適用するワークフローを実装しています。開発者やAIエージェントユーザーにとって、実験的な設定変更を安全に行える環境を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add jzOcb/config-guard

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

config-guard は何をしますか?

設定変更の検証、自動バックアップ、スキーマ検証、自動ロールバックにより、AIエージェントがOpenClawをクラッシュさせるのを防ぎます。

概要

このスキルは、AIエージェントがOpenClawの設定ファイルを変更する際に、システムの安定性を保証するためのガード機構を提供します。設定変更前の自動バックアップ、設定値のスキーマ検証、問題発生時の自動ロールバックを実行します。

機能

  • 自動バックアップ: 設定変更前に既存の設定ファイルを自動的にバックアップします。
  • スキーマ検証: 変更内容を定義済みスキーマと照合し、無効な設定値の適用を防ぎます。
  • 自動ロールバック: 設定変更後にOpenClawのクラッシュを検出した場合、自動的に設定をバックアップから復元します。

使用方法

# 設定変更を行う前に、config-guardを有効化
config-guard enable

# 設定ファイルを変更(例:OpenClawの設定)
openclaw config set some.key=value

# config-guardが自動的にバックアップと検証を実行
# 問題がなければ変更が適用され、問題があればロールバック

対応プラットフォーム

  • Claude Code
  • Cursor
  • Codex
  • その他のAIエージェントツール

動作の仕組み

  1. バックアップフェーズ:

    • 設定変更が検出されると、config-guardは既存の設定ファイルを~/.config-guard/backups/ディレクトリにコピーします。
    • バックアップファイルにはタイムスタンプが付与され、復元ポイントとして使用されます。
  2. 検証フェーズ:

    • 変更された設定値を、OpenClawのスキーマ定義と照合します。
    • 無効なキーや値の範囲外の値が指定された場合、変更はブロックされます。
  3. ロールバックフェーズ:

    • OpenClawのプロセスを監視し、設定変更後にクラッシュが発生した場合、自動的にバックアップから設定を復元します。
    • ロールバックが成功したかどうかを標準出力に通知します。

環境変数

  • CONFIG_GUARD_ENABLED: trueまたはfalseで有効/無効を切り替え(デフォルト: true)
  • CONFIG_GUARD_BACKUP_DIR: バックアップディレクトリのパス(デフォルト: ~/.config-guard/backups/)
  • CONFIG_GUARD_SCHEMA_PATH: 使用するスキーマファイルのパス(デフォルト: 組み込みスキーマ)

注意事項

  • このスキールはOpenClawの設定変更にのみ適用されます。他のアプリケーションの設定変更には影響しません。
  • バックアップは設定変更前に自動的に作成されるため、手動でバックアップを取る必要はありません。
  • ロールバックが頻発する場合は、スキーマ定義や設定値を見直すことを推奨します。

ライセンス

MIT

関連スキル