Aegis – 可信 AI 编码代理的方法包

它是什么

• 一个方法包，为 AI 驱动的编码助手（Codex、Claude Code、OpenCode、DeepSeek、Kimi 等）添加工程纪律。
• 它不提供运行时或守护进程；它提供一组宿主代理可以调用的“技能”、策略和验证步骤。

为什么你可能关心

• 减少你不断观察代理的需求（“停止保姆式监督”）。
• 提高安全性：在作者的基准测试中，合同通过率从约 62% 上升到约 93%，不安全结果降至 0%。
• 在“完成”之前给你证明——代理必须在声明任务完成之前产生新鲜证据（例如测试结果、设计检查）。
• 保持简单请求简单；只有在任务确实需要时才添加重量级仪式。

关键概念

概念	作用
基线对齐	在编辑之前，代理检查当前项目基线（所有者、合同、边界）以避免猜测。
基于证据的完成	代理必须附加你可以检查的验证工件（测试、设计审查、风险分析）。
退役触发	旧代码路径或“幽灵”代码路径被跟踪，可以自动退役，防止无声的技术债务。
UI/UX 治理	可选技能（ui-ux-governance），强制执行 UI/UX 设计规则并产生范围化的体验证据。
多主机支持	包可以作为插件安装到许多 AI 编码主机（Codex、Claude Code、OpenCode、DeepSeek Harness、Kimi 等）。
TDD 模式	可以设置为 off、auto 或 strict；开启时，代理通过测试优先工作流程路由任务。
激活模式	automatic（默认）或 explicit；控制包是否在主机启动时自动激活。

安装（快速入门）

1. 向你的 AI 编码代理发送以下提示（如果需要，替换主机名）：

   Read https://github.com/GanyuanRan/Aegis, identify my current AI coding host, and install Aegis globally using the correct host guide. …
   

2. 代理将运行特定于主机的插件命令（例如 dsh plugin --profile <profile> add "git+https://github.com/GanyuanRan/Aegis.git"）。
3. 安装后，使用医生脚本验证：

   cd <aegis-method-pack-root>
   python scripts/aegis-doctor.py --write-config --json
   

   成功是包含 "ok": true、"workspaceSupport": "available" 和 "configStatus": "configured" 的 JSON。
4. （可选）使用相同的医生脚本切换激活或 TDD 模式，例如：

   python scripts/aegis-doctor.py activation-mode explicit
   python scripts/aegis-doctor.py tdd-mode auto
   

支持的主机（截至 README 的状态）

• 完全验证：Codex、OpenCode。
• 有指南，冒烟测试待定：Claude Code、CodeBuddy、DeepSeek-TUI、DeepSeek Harness、Trae、GitHub Copilot、Qoder、Kimi Code CLI、ZCode、Grok Build、CC GUI（JetBrains IDEA）。
• 仅结构支持：Antigravity CLI/IDE/App、Pi CLI、OMP、OpenClaw、Hermes Agent。
• 已退役：Gemini CLI。

测量基准

• 冻结的 A/B 基准测试（120 次运行，20 个案例），使用相同模型（gpt-5.6-sol / xhigh）。
• 合同通过率：61.67% → 93.33%（+31.67 个百分点）。
• 不安全结果：13.33% → 0%。
• 结果仅供参考，不是独立审计，仅适用于 Aegis 2.7.6（2026-08-11）。
• 完整数据和方法在 benchmarks/ 和 docs/current/AEGIS_AGENTIC_BENCHMARK_BASELINE.md 中。

运行时体验（可选）

• 作者还发布了 Autoloom，一个仅限 Windows 的桌面客户端，将 Aegis 方法嵌入编码工作流程。Autoloom 免费但其源代码不公开；它提供了一个用于变更必要性分析、复杂性治理和交付审查的 UI。

日常使用方式

• 安装后，只需像平常一样与你的代理交谈。使用前缀命令调用 Aegis 行为，例如：

  Aegis goal: Refactor the auth module without breaking existing contracts.
  Grill me on whether we should ship a hosted version first.
  TDD Route: strict
  

• 该包将自动决定是运行轻量级快速路径还是参与完整的证据收集工作流程。

开发与测试

• 端到端测试套件：bash tests/e2e/run-all.sh --full --host-profile fast。
• 针对边界合规、工作流质量、安装验证等的定向检查（参见 tests/e2e/ 脚本）。
• 贡献指南在 CONTRIBUTING.md 中。

许可证

• MIT 许可证。

---

底线：Aegis 是一个开源“方法包”，将纪律性工程实践分层到现有 AI 编码代理上，旨在使其输出更安全、更可信，同时保持开发人员的工作流程轻量。