GanyuanRan/Aegis

Aegis – 信頼できるAIコーディングエージェントのためのメソッドパック

何であるか – Aegis は Codex、Claude Code、DeepSeek Harness、GitHub Copilot など、さまざまなAIコード生成ホストに追加できる メソッドパック（プロンプト、設定ファイル、ヘルパー スクリプトのコレクション）です。新しいモデルやデーモンを提供するものではなく、ホストが慎重なソフトウェアエンジニアのように振る舞うようになるための体系的なワークフロー層を追加します。

なぜ重要か – AIコーディングエージェントは強力ですが、安全でない、または不完全な変更を生成する可能性があり、人間によるレビューが必要です。Aegis は以下の方法でその「監視」を軽減しようとします：

• どの編集も行う前に、実際のプロジェクトベースラインに沿った計画を実施。
• タスクを「完了」と宣言する前に、最新の検証証拠（テスト、契約チェック）を要求。
• 単純なリクエストは高速パスで処理し、リスクの高い作業のみに自動的に儀式を追加。
• 非使用コードパスを追跡し、隠れた技術的負債を回避。

主な主張（リポジトリ内ベンチマークによる裏付け）

メトリクス	Aegisなし	Aegisあり
契約通過率	61.7 %	93.3 %
安全でない結果	13.3 %	0 %
これらの数値は、gpt-5.6-sol / xhigh 設定を使用した、120回の実行・20ケースの固定A/Bベンチマークから得られています。READMEでは、この証拠は参考情報であり、普遍的な保証ではないと強調しています。

使い方

1. インストール – AIコーディングエージェントに、リポジトリを読み込み、使用中のホストを検出し、ホスト固有のインストールコマンド（例：dsh plugin --profile <profile> add "git+https://github.com/GanyuanRan/Aegis.git"）を実行するよう指示する単一のプロンプトを渡します。
2. 検証 – 付属の scripts/aegis-doctor.py スクリプトを実行します。成功したJSON出力には、"ok": true、"workspaceSupport": "available"、"configStatus": "configured" が含まれます。
3. 有効化 – パックはデフォルトで 自動有効化 と TDDオフ です。同じドクタースクリプトで明示的有効化または自動TDDに切り替えられます。
4. 対話 – インストール後は通常通りエージェントとやり取りできますが、Aegis固有のトリガーを追加できます：
   • Aegis goal: … – 範囲、成功の証拠、境界を定義。
   • Grill me … – 単一質問の意思決定インタビューを開始。
   • TDD Route: strict / test-first – テスト先行ワークフローを強制。
   • aegis:update – ホスト対応パス経由でメソッドパックを更新。

対応ホスト – パックには多くの人気のあるコード生成ツールのインストールガイドが付属しています。一部のホストはガイドのみ（最新のスモークテストは未実施）ですが、Codex、OpenCode などはすでにベンチマーク証拠があります。

開発とテスト – リポジトリには、インストール、ワークフロー品質、ホスト固有の準拠性を検証するエンドツーエンドテスト（tests/e2e/*.sh）のセットが含まれています。

コミュニティ – READMEから、ディスカッション、イシュー追跡、DEV.to記事へのリンクがあります。プロジェクトはMITライセンスで、以前の Superpowers フレームワークに基づいています。

結論 – すでにAIコーディングアシスタントを使っている場合、計画、検証、リスク認識ルーティングを追加して、より体系的なエンジニアのように振る舞わせるプラグインスタイルの方法を探しているなら、Aegisはホストに依存しない、即戦力のメソッドパックを提供します。