by GanyuanRan
Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks.
# Add to your Claude Code skills
git clone https://github.com/GanyuanRan/AegisLast scanned: 5/27/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-27T08:04:01.086Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}Aegis is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by GanyuanRan. Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks. It has 571 GitHub stars.
Yes. Aegis passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/GanyuanRan/Aegis" and add it to your Claude Code skills directory (see the Installation section above).
Aegis is primarily written in Shell. It is open-source under GanyuanRan on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Aegis against similar tools.
No comments yet. Be the first to share your thoughts!
Aegis 是面向真实软件工作的 Superpowers 升级版。它保留 composable 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, ZCode |
已有安装说明；release-level fresh host smoke 仍待补证 | Claude Code, CodeBuddy, DeepSeek-TUI, Trae, GitHub Copilot, Qoder, ZCode |
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, 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 在实施前按复杂度路由：
核心纪律是：
完整说明见：
主要验证入口：
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。