Aegis Method Pack
面向 AI 编程 agent 的 baseline-first、evidence-driven 工作流程纪律包。
中文 · English · 工作流程说明 · Workflow Guide
Aegis 是面向真实软件工作的 Superpowers 升级版。它保留 composable skills 的优点，并进一步加入：
- baseline first：高风险改动前先读当前项目事实
- evidence before completion：没有 fresh verification evidence，不声明完成
- repair track + retirement track：修复问题时同步说明旧路径保留或退役
- 工作流质量（Workflow Quality）护栏：简单任务保持轻量，风险升高才展开
- 多宿主可移植 method-pack skills
当 agent 容易在目标、owner、架构边界或验证路径不清楚时就开始写代码，Aegis 能把工作拉回更稳的工程节奏。
把下面这段话交给你的 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>` 验证它指向当前版本。
完成安装并登记当前宿主之后，后续更新可以用自然语言直接让 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。
为了让宿主级行为更顺滑，可以使用：
Aegis 默认自动模式。要切换到显式模式，在已安装的 method-pack 根目录运行：
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py activation-mode explicit修改后需要重启宿主。长期设置方式和宿主注意事项见 docs/current/AEGIS_ACTIVATION_MODE.md。
TDD mode 默认是 auto：Aegis 会按风险自动选择严格 TDD、轻量验证，或在
不适合 TDD 的任务中跳过 TDD。若只想关闭自动 TDD 路由，但仍保留完成前验证：
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py tdd-mode off详细语义见 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 |
已有安装说明；release-level fresh host smoke 仍待补证 | Claude Code, CodeBuddy, DeepSeek-TUI, Trae, GitHub Copilot, Qoder |
CC GUI (JetBrains IDEA) |
Claude Code / OpenAI-GPT 通道的 IDE 插件层结构性支持；release-level fresh host smoke 仍待补证 | CC GUI |
Antigravity CLI, Antigravity IDE, Antigravity App |
结构性目标；release-level fresh host smoke 仍待补证 | Antigravity |
Pi CLI, OpenClaw, Hermes Agent |
结构性 Agent Skills / SKILL.md skill-host 适配；release-level fresh host smoke 仍待补证 |
Pi CLI, OpenClaw, Hermes Agent |
Gemini CLI |
Antigravity 支持成熟前的过渡兼容面 | 兼容性矩阵 |
对外声明支持状态前，先读：
安装并重启宿主后，直接自然描述开发任务即可。任务匹配时，agent 应选择对应 Aegis 方法。
高风险任务前可以先用轻量目标框定；它会先框定目标，然后默认继续进入已选 workflow：
Aegis goal: 修复登录后偶发跳回登录页，不重写 auth 系统。
当你想强制指定方法时，可以显式点名 skill：
aegis:brainstormingaegis:systematic-debuggingaegis:writing-plansaegis:first-principles-reviewaegis:requesting-code-reviewaegis:verification-before-completion
如果预期 skill 没有触发，不要先当成提示词措辞问题。按触发链路诊断：
安装/版本可见性、宿主 skill discovery、activation mode、using-aegis 路由、
任务到 skill 的匹配、以及上下文压力。阅读
docs/current/AEGIS_TRIGGER_HEALTH_BASELINE.md。
Aegis 在实施前按复杂度路由：
- 低复杂度：简短 intent、baseline check、TDD Route、验证。
- 中复杂度：baseline read set、Spec Brief 或稳定需求、writing plan、atomic tasks、验证。
- 高复杂度：Design Spec、plan、必要时用户确认，然后执行。
核心纪律是：
- Baseline first：重大改动前先读当前项目 authority。
- Evidence before claims：没有 fresh verification evidence，不声明完成。
- Repair plus retirement：修复 owner，同时说明旧路径保留或退役。
- Workflow Quality：简单任务保持轻量，风险升高才展开。
完整说明见：
主要验证入口：
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阅读：
Aegis 派生自 Superpowers，由 Jesse Vincent 创建。Superpowers 开创了 composable、 multi-harness agent skills 的基础；Aegis 在此基础上加入面向真实软件项目的 architecture- and evidence-focused method layer。
项目还借鉴了 mattpocock/skills 中关于极简沟通、共享语言和严谨调试的思路。这些思路均在 Aegis 自有格式中 重新实现，而不是原样复制。
MIT License。见 LICENSE。
