GanyuanRan/Aegis

Aegis – 可信 AI 程式碼助手的流程套件

是什麼 – Aegis 是一個 方法套件（一組提示、設定檔與輔助腳本），可加入多種 AI 程式碼產生主機，如 Codex、Claude Code、DeepSeek Harness、GitHub Copilot 等。它不提供新模型或守護程序；而是為主機添加一個有紀律的工作流程層，使其行為更像一位謹慎的軟體工程師。

為何重要 – AI 程式碼助手功能強大，但可能產生不安全或不完整的變更，需人工審查。Aegis 嘗試減少這種「監看」負擔，透過：

• 在任何編輯前，依據真實專案基準進行規劃。
• 在宣告任務「完成」前，要求提供新的驗證證據（測試、契約檢查）。
• 對簡單請求保持快速路徑，僅對高風險工作自動加入儀式性流程。
• 追蹤已停用的程式碼路徑，避免隱藏的技術負債。

關鍵主張（由倉儲自身基準測試支持）

指標	無 Aegis	有 Aegis
契約通過率	61.7 %	93.3 %
不安全結果	13.3 %	0 %
這些數字來自使用 gpt-5.6-sol / xhigh 設定的固定 A/B 基準測試（120 次執行，20 個案例）。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 提供了一個即用型、主機無關的方法套件來達成此目標。