8000 GitHub - Aonggg/Aegis: Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks. · GitHub
[go: up one dir, main page]

Skip to content
AongggPublic
forked from GanyuanRan/Aegis

About

Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

75 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aegis 架构驱动 AI 编程 agent 头图

Aegis

Aegis Method Pack
面向 AI 编程 agent 的 baseline-first、evidence-driven 工作流程纪律包。

中文 · English · 工作流程说明 · Workflow Guide

为什么需要 Aegis

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>` 验证它指向当前版本。

更新 Aegis

完成安装并登记当前宿主之后,后续更新可以用自然语言直接让 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:brainstorming
  • aegis:systematic-debugging
  • aegis:writing-plans
  • aegis:first-principles-review
  • aegis:requesting-code-review
  • aegis: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

阅读:

与 Superpowers 的关系

Aegis 派生自 Superpowers,由 Jesse Vincent 创建。Superpowers 开创了 composable、 multi-harness agent skills 的基础;Aegis 在此基础上加入面向真实软件项目的 architecture- and evidence-focused method layer。

项目还借鉴了 mattpocock/skills 中关于极简沟通、共享语言和严谨调试的思路。这些思路均在 Aegis 自有格式中 重新实现,而不是原样复制。

许可证

MIT License。见 LICENSE。

AI编程工具Aegis_QQ交流群:694329785

Aegis QQ交流群二维码

About

Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0