repo-sentinel-ai-agent-skill は何をしますか？
Claude Code と OpenAI Codex 向けの小さな AI エージェントスキル：リポジトリ検査、安全なコード変更、およびローカル検証証拠。
概要
このスキルは、AI エージェント（Claude Code や OpenAI Codex など）がリポジトリに対して安全に変更を加えるためのフレームワークを提供します。変更前のリポジトリの状態を検査し、変更計画を立案し、変更を適用した後、自動テストを実行して検証し、その証拠（変更差分やテスト結果）を記録します。
主な機能
- リポジトリ検査: 変更前にプロジェクト構造、依存関係、既存のコードを分析します。
- 変更計画: 明確で安全な変更計画を生成します。
- 変更の適用: 計画に基づいてコード変更を適用します。
- ローカル検証: ビルド、リント、テストを実行し、変更が正しいことを確認します。
- 証拠の記録: 変更差分とテスト結果をファイルに保存し、後から確認できるようにします。
対応プラットフォーム
- Claude Code
- OpenAI Codex (および互換性のある他の AI エージェント)
使用方法
スキルを有効にするには、エージェントの設定ファイルに以下のように追加します：
{
"skills": [
"hzs0623/repo-sentinel-ai-agent-skill"
]
}
または、CLI から直接スキルを指定して使用することもできます：
claude use-skill hzs0623/repo-sentinel-ai-agent-skill
ワークフロー
- 検査フェーズ: リポジトリをスキャンし、現在の状態を把握します。
- 計画フェーズ: 変更内容を明確に定義し、計画を作成します。
- 適用フェーズ: 計画に従ってコードを変更します。
- 検証フェーズ: テストを実行し、変更が機能を壊していないことを確認します。
- 記録フェーズ: 変更差分とテスト結果を
change-evidence/ディレクトリに保存します。
設定
スキルは環境変数 REPO_SENTINEL_VERBOSE をサポートしており、これを設定すると詳細なログが出力されます。
export REPO_SENTINEL_VERBOSE=true
注意事項
- このスキルは、変更を自動的に適用する前に、常にユーザーの承認を求めます。
- 変更証拠は
.gitignoreに追加することを推奨します。
ライセンス
MIT