Aegis Method Pack
让 AI 编程 agent 变得可信：少返工、更安全、说“完成”前先给证据。
中文 · English · 速通秘籍 · Fast-Track Playbook
别再全程盯着 agent 干活。 Aegis 让 agent 动手前先对齐你的真实基线、 完成前先给证据、简单任务不打扰你——你拿到的是：更少返工、更安全、 不用盲信“done”。
Aegis 是一套方法包，让 AI 编程 agent 像有工程纪律的人一样干活——你不需要 全程盯梢。
- 更少返工。 agent 动手前先对齐项目真实基线（owner、契约、边界）， 不再靠猜，你也不用为猜错买单。
- 更安全的改动。 冻结的 held-out A/B 实测：合同通过率 60% → 90%， 不安全结果 11.67% → 5%。
- 说“完成”前先给证据。 每个完成声明都带 fresh 验证证据、覆盖范围与 残余风险——你读的是证据，不是感觉。
- 不留幽灵代码。 退役的 fallback 和旧路径会被显式跟踪或带退役触发条件 移除，技术债不再悄悄累积。
- 简单任务保持简单。 平凡请求留在 fast-path，只有任务真正需要时才展开 仪式。
- 一套方法包，多宿主通用。 Codex、Claude Code、OpenCode、Kimi 等 skill-aware 宿主体验一致。
上面的数字来自下方冻结 benchmark 的有界建议性证据，不构成普遍质量或完成 权威声明。
本次冻结的 held-out A/B benchmark（Aegis 2.5.5，2026-07-31）在两组中使用相同的 Codex 客户端、gpt-5.6-sol 模型、xhigh 推理档位、prompt、项目和工具策略；唯一差异是是否投影 Aegis method pack。在 20 个案例、120 次有效运行中：合同通过率 60% → 90%（+30 个百分点），不安全结果率 11.67% → 5%。
有界、建议性证据，不构成普遍质量或完成权威声明；完整结果与方法见已发布报告。
测量状态：该快照覆盖 Aegis 2.5.5。当前版本的重新测量尚未完成，只有在经过验证的 held-out batch 完成后才会在此发布新结果；旧快照的数字不应被当作新版本的证据。
脱敏 JSON · 中文表格 · English table · 方法与证据边界
第一次使用？最快路径是把下面这段话交给你的 agent，完整安装与验证流程就在其中。
把下面这段话交给你的 AI 编程 Agent：
请阅读 https://github.com/GanyuanRan/Aegis，识别我当前使用的 AI 编程宿主，并按对应宿主说明全局安装 Aegis。如果需要重启或重新加载宿主，请明确告诉我；然后从已安装的 Aegis method-pack 根目录运行完整安装验证。不要在目标项目目录中运行 doctor 命令。先定位 `<aegis-method-pack-root>`，再运行 `cd <aegis-method-pack-root> && python scripts/aegis-doctor.py --write-config --json`。只有当 JSON 输出包含 `"ok": true`、`"workspaceSupport": "available"` 和 `"configStatus": "configured"` 时，才把安装视为完成；如果宿主有单独的 skill discovery 目录，也要额外用 `--discovery-root <path>` 验证它指向当前版本；如果宿主说明声明了 skill 目录名前缀，也同时传 `--discovery-name-prefix <prefix>`。
完成安装并登记当前宿主之后，后续更新可以用自然语言直接让 agent 更新 Aegis，
也可以显式说 aegis:update。agent 可以把这两种方式路由到本地更新路径：先定位
已安装的 method-pack 根目录，读取本机 host-scoped registry，再调用
scripts/aegis-update.py 默认更新当前宿主。只有用户明确要求 --all 时才更新所有
已登记宿主。Aegis 默认不做后台自动更新。
Aegis 当前发布形态是：
Aegis Method Pack (runtime-ready)
它不是完整的 Aegis Platform，不是 daemon，不是后台 runner，不是 runtime core，
不提供 authoritative GateDecision，不提供 authoritative PolicySnapshot，
也不授予 final completion authority。用户当前指令和目标项目规则优先于 Aegis。
下面的文件是可选、手工复制的宿主/profile 投影，不负责安装 Aegis，也不能证明 skill 已经可发现。如果宿主已有可靠的 Aegis bootstrap 与路由，通常无需为了路由 再复制全局规则；否则先复制 Lite 作为完整基础 profile。Advanced 不是独立模板， 只在确实需要持久治理偏好时按需追加：
这些手工副本不由 aegis:update 管理。Lite 负责默认 auto activation profile
及其 explicit 模式替换条款；Advanced 继承该选择，不再重复一份。切换到
explicit 时也要同步修改已复制的 Lite profile。宿主原生 skill 匹配是否仍会
触发，继续由宿主能力决定。
Aegis 默认自动模式。要切换到显式模式，在已安装的 method-pack 根目录运行：
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py activation-mode explicit修改后需要重启宿主。长期设置方式和宿主注意事项见 docs/current/AEGIS_ACTIVATION_MODE.md。
TDD mode 默认是 off：Aegis 不会自动要求 TDD，但完成前验证仍然适用。若希望
Aegis 按任务风险自动选择严格、轻量或跳过 TDD，可以手动开启：
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py tdd-mode auto也可以在 query 中用 TDD Route: strict、strict TDD、test-first 或
RED / GREEN / REFACTOR 显式要求严格 TDD。
详细语义见 docs/current/AEGIS_TDD_MODE.md。
Aegis 保留多宿主、plugin-installable 的分发目标。
| 宿主组 | 当前状态 | 从这里开始 |
|---|---|---|
Codex, OpenCode |
当前 method-pack 范围内已有 fresh evidence | Codex, OpenCode |
Claude Code, CodeBuddy, DeepSeek-TUI, Trae, GitHub Copilot, Qoder, Kimi Code CLI, ZCode, Grok Build |
已有安装说明；release-level fresh host smoke 仍待补证 | Claude Code, CodeBuddy, DeepSeek-TUI, Trae, GitHub Copilot, Qoder, Kimi Code CLI, ZCode, Grok Build |
CC GUI (JetBrains IDEA) |
Claude Code / OpenAI-GPT 通道的 IDE 插件层结构性支持；release-level fresh host smoke 仍待补证 | CC GUI |
Antigravity CLI, Antigravity IDE, Antigravity App |
Antigravity CLI 是当前主动 closeout 目标；IDE/App 仍是结构性目标，release-level fresh host smoke 仍待补证 |
Antigravity |
Pi CLI, OMP, OpenClaw, Hermes Agent |
结构性 Agent Skills / SKILL.md skill-host 适配；release-level fresh host smoke 仍待补证 |
Pi CLI, OMP, OpenClaw, Hermes Agent |
Gemini CLI |
Antigravity 支持成熟前的过渡兼容面 | 兼容性矩阵 |
对外声明支持状态前，先读：
安装并重启宿主后，直接用自然语言描述工作即可。Aegis 会按任务匹配方法；需要 更确定的行为时，再直接点名模式。
这个登录失败的根因是什么？先诊断，不要立刻改代码。
审问我：我们是否应该先发布托管版？
Aegis goal: 修复登录后偶发跳回登录页，不重写 auth 系统。
在我合并前，独立审查这个 diff。
先阅读 Aegis 速通秘籍：其中说明 Aegis 为什么轻量、它与独立 skill pack 的区别、五道工程护城河、项目工作区生命周期、 自然触发语句、activation/TDD 控制和常见排障。英文版见 Fast-Track Playbook。
当你需要更强控制时，可以这样说：
Aegis goal: ...：框定范围、成功证据与边界。Grill me ...、审问我 ...：进入决策访谈；每轮只问一个决策问题，不写计划、 不实施。TDD Route: strict、strict TDD或test-first：显式要求严格 test-first； TDD 默认保持off。aegis:first-principles-review或“用第一性原理审查”：在实施前挑战复杂方向。aegis:update：按当前宿主的本地路径更新已安装的 method pack。
对非平凡项目任务，Aegis 可以被动复用 CONTEXT.md，或通过
CONTEXT-MAP.md 选择相关 bounded context 的规范术语。只有术语已经确定、存在
歧义、发生重命名/废弃或与现有证据冲突时，才进入主动领域建模。高置信度的既有事实
可直接同步；尚未作出的领域决策仍由用户决定。文件在第一个已解决术语出现时惰性创建，
且只保存术语。稳定字节有利于缓存，但 Aegis 不保证供应商缓存命中或费用节省。
Aegis 用 Workflow Quality 让简单任务保持轻量，只在风险需要时展开。想深入了解 方法时，阅读 工作流程说明、 工作流质量基线、 复杂度治理基线 和 TDD 模式。
如果预期能力没有触发，不要先当成措辞问题。按触发链路诊断：安装/版本可见性、
宿主 skill discovery、activation mode、using-aegis 路由、任务到 skill 的匹配和
上下文压力。阅读
触发健康基线。
主要验证入口：
bash tests/e2e/run-all.sh --full --host-profile fast聚焦文档 / method-pack 检查：
bash tests/e2e/boundary-compliance-check.sh
bash tests/e2e/workflow-quality-check.sh
bash tests/e2e/install-verification-policy-check.sh
bash tests/e2e/layer1-fast-check.sh --host-profile none阅读：
- 反馈与讨论：GitHub Discussions · Issues · LINUX DO · DEV.to
- 扩展 Aegis：使用 aegis:writing-skills 写自己的 skill；参见工作流指南。
- 关注发布：RELEASE-NOTES.md · Releases
Aegis 派生自 Superpowers，由 Jesse Vincent 创建。Superpowers 开创了 composable、 multi-harness agent skills 的基础；Aegis 在此基础上加入面向真实软件项目的 architecture- and evidence-focused method layer。
项目还借鉴了 mattpocock/skills 中关于极简沟通、共享语言和严谨调试的思路。这些思路均在 Aegis 自有格式中 重新实现，而不是原样复制。
MIT License。见 LICENSE。
