• AI 技能
• AI 插件
• dsh-plugin

Aegis 是一套面向 AI 编程 Agent 的工程纪律方法包（Method Pack），它通过"基线先行、证据验证、漂移检查"让 Claude Code、Codex、OpenCode、Kimi Code CLI 等多种宿主上的 Agent 更可靠：改代码前对齐项目真实基线，宣告"完成"前必须给出新鲜验证证据，简单任务则走快速通道不打扰你。本文给出 Aegis 多宿主支持完整清单，以及各宿主的安装与验证步骤，新手照做即可完成全局安装。

Aegis 能帮你解决什么？

用一句话概括：Aegis 让你的 AI 编程助手像有纪律的工程师一样工作，而不用你全程盯着。

• 少返工：Agent 动手前先对齐项目的负责人、契约与边界，不再靠猜。
• 更安全：在冻结的 A/B 基准上，契约通过率从61.67% 提升到 93.33%，不安全结果从13.33% 降到 0%（有限参考证据，详见 基准结果表格）。
• "完成"要有证据：结束声明附带新鲜验证证据、覆盖范围与剩余风险，你读的是证据而不是感觉。
• 简单任务保持简单：琐事走快速路径，仪式只在真正需要时才出现。

更多方法细节可阅读 工作流指南 和速通秘籍（中文）。

Aegis 多宿主支持完整清单

Aegis 采用"一套方法包、所有宿主"的多宿主插件化分发策略。截至当前快照（2026-08-27），各宿主状态如下：

📌 阅读顺序建议：先看宿主兼容性矩阵了解当前判定，再看已知限制。

最快安装方法：把一段提示词交给你的 Agent

如果你不确定自己宿主的具体路径，最快的方式是直接把下面这段提示词发给正在使用的 AI 编程 Agent（它会识别宿主、按对应指南安装并完成验证）：

请阅读 Aegis 仓库，识别我当前使用的 AI 编程宿主，并按对应宿主指南全局安装 Aegis； 需要时重启宿主，然后从已安装的 Aegis method-pack 根目录运行完整安装验证。 只有当验证 JSON 包含 "ok": true、"workspaceSupport": "available"、 "configStatus": "configured" 时，才把安装视为完成。

下面再按宿主给出手动安装要点，方便你想亲手操作时参考。

Claude Code：插件市场三步安装

在 Claude Code 会话中依次执行：

/plugin marketplace add GanyuanRan/Aegis /plugin install aegis@aegis-dev --scope user /reload-plugins

• --scope user为全局安装；只有想让项目自身记录插件时才用--scope project。
• 插件骨架由.claude-plugin/marketplace.json声明，自动入口依赖启动 hook（hook-bootstrap型宿主）。
• 详细步骤见 docs/README.claude-code.md。

Codex：clone + 软链接全局安装

Codex 原生扫描~/.agents/skills/发现技能，因此只需两步：

git clone https://gitcode.com/gh_mirrors/aegis21/Aegis ~/.codex/aegis mkdir -p ~/.agents/skills && ln -s ~/.codex/aegis/skills ~/.agents/skills/aegis

重启 Codex 即可。Windows 用户可用mklink /J创建 junction 替代软链接（无需开发者模式）。using-aegis技能会被自动发现并约束技能使用纪律，无需额外配置。详见 docs/README.codex.md。

OpenCode：一行插件配置

在opencode.json（全局或项目级）的plugin数组中加入：

{ "plugin": ["aegis@git+https://github.com/GanyuanRan/Aegis.git"] }

重启 OpenCode 后，插件会自动安装、把 Aegis 技能镜像到~/.config/opencode/skills/发现路径并注入引导上下文。可以问一句 "Tell me about your aegis" 快速确认。详见 docs/README.opencode.md。

Kimi Code CLI：原生插件一步安装

Kimi 的默认安装路径是根目录kimi.plugin.json声明的原生 Aegis 插件，每个新会话自动以using-aegis作为路由入口：

/plugins install https://github.com/GanyuanRan/Aegis /plugins info aegis /reload

确认有且仅有一个启用的aegis插件即可；不要再额外暴露到~/.kimi-code/skills/或~/.agents/skills/（两条路径不能同时激活，否则会形成重复技能所有者）。详见 docs/README.kimi-code.md。

安装完成验证：一条命令确认

无论哪个宿主，安装完成后都应从已安装的 Aegis method-pack 根目录（注意：不要在目标项目目录里运行）执行：

python scripts/aegis-doctor.py --write-config --json

只有当输出同时满足以下条件，才算完整安装：

• "ok": true
• "workspaceSupport": "available"（项目工作区支持可用）
• "configStatus": "configured"

该诊断脚本源码见 scripts/aegis-doctor.py。如果宿主有单独的 skill 发现目录，可追加--discovery-root <path>验证。

更新与激活模式：装好之后的日常操作

• 更新 Aegis：安装并登记宿主后，直接用自然语言说更新 Aegis，或显式请求aegis:update，Agent 会通过宿主感知的本地路径调用 scripts/aegis-update.py 完成更新；更新所有已登记宿主需显式加--all。Aegis 默认不做后台自动更新。
• 激活模式：默认auto（自动路由）。想改为"显式点名才生效"，可在 method-pack 根目录运行python scripts/aegis-doctor.py activation-mode explicit后重启宿主，规则说明见 docs/current/AEGIS_ACTIVATION_MODE.md。
• 日常使用：直接用自然语言即可，例如：
  • Why does this login failure happen? Diagnose it before changing code.
  • Aegis goal: Fix the auth refresh bug without rewriting the auth system.
  • Review this diff independently before I merge it.

常见问题

Q1：装好了但 Aegis 没有自动触发，怎么办？按触发链路逐级排查：安装/版本可见性 → 宿主技能发现 → 激活模式 →using-aegis路由 → 任务与技能匹配 → 上下文压力。诊断清单见 docs/current/AEGIS_TRIGGER_HEALTH_BASELINE.md。

Q2：Claude Code / Kimi 等有最新冒烟证据吗？有最新证据的是 Codex 与 OpenCode；Claude Code、Kimi Code CLI 等宿主的安装指南已就绪，但 release 级新鲜宿主冒烟仍待补证——状态以宿主兼容性矩阵为准。

Q3：Aegis 会接管宿主或改变我的全局规则吗？不会。Aegis 是独立方法包，不是运行时核心或后台进程；用户指令与目标项目规则始终优先于 Aegis 指引，产品边界见 docs/current/AEGIS_PRODUCT_BASELINE.md。

• AI 技能
• AI 插件
• dsh-plugin