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 提供了一个即用型、主机无关的方法包来实现这一目标。