aegis 是什么？让 AI 编码代理先对齐基线再动手

aegis 是 DeepSeek Harness（DSH）的架构感知方法包，让 AI 编码代理像严谨的工程师一样工作：编辑前先对齐真实基线，完成时用新鲜证据证明，简单任务保持简单——少返工、变更更安全，不再盲目相信「完成」。 本文介绍 aegis 是什么、核心功能、完整的安装更新卸载命令、典型用法与常见排错，助你在 DSH Plugin 生态中让代理更可靠。

aegis 是什么？

aegis 解决的是「AI 编码代理拿到任务就动手」的问题：它让代理先对齐项目的真实基线（所有者、契约、边界），再用新鲜证据证明完成，而不是靠感觉说「好了」。 以下定位与事实均来自官方 README（来源）：

aegis（GitHub 仓库 GanyuanRan/Aegis）由 GanyuanRan 维护、采用 MIT 协议开源。它源自 obra 的 Jesse Vincent 创建的 Superpowers，是一套方法包（method pack）而不是完整平台：没有守护进程、后台运行器或运行时核心，也不扮演权威的 GateDecision 与 PolicySnapshot，用户指令和目标项目规则始终优先。它跨宿主一致地适用于 Codex、Claude Code、OpenCode、Kimi 等技能感知宿主；在 DeepSeek Harness（DSH）中它以 thin bundle 形式加载，注册名 aegis-method-pack。当前状态是 Aegis Method Pack（runtime-ready），属于 DSH Plugin 生态的一员。

aegis 的核心功能有哪些？

aegis 的核心能力围绕「基线优先 + 证据验证 + 漂移检查 + 退役触发」展开：编辑前对齐真实基线，完成时拿新鲜证据说话，并在长任务中让简单任务保持简单、跨宿主复用同一套纪律。 这些能力全部来自官方 README（来源）：

• 基线优先：编辑前先对齐项目的所有者、契约和边界，避免代理盲目猜测导致返工。
• 证据验证：完成声明附带新鲜验证证据、覆盖范围和残余风险，让你基于证据而非感觉判断是否完成。
• 漂移检查：在冻结的 A/B 基准（120 次有效运行、20 个用例）上，契约通过率从 61.67% 提升到 93.33%，不安全结果从 13.33% 降至 0%；这是有限的参考证据，不是普遍质量或完成权威声明。
• 退役触发：跟踪或移除已退休的回退与旧路径，防止幽灵代码和技术债务静默积累。
• 简单任务保持简单：琐碎请求走 fast path 快速通道，不会被过重流程拖慢。
• 跨宿主一致：在 Codex、Claude Code、OpenCode、Kimi 等宿主上提供同一套纪律；在 DSH 中为 thin bundle，注册名 aegis-method-pack。

怎么安装与启用 aegis？

安装 aegis 需要在 DeepSeek Harness 里执行 dsh plugin 命令，显式使用 git+https:// 形式，装完依次验证插件列表、dump-config 与 doctor 三关，随后即可使用。 前置要求：pnpm 必须在 PATH——Harness 会把 dsh plugin 操作转发给 pnpm（来源）：

1. 安装 aegis：在目标 profile（示例为 web）执行安装命令。官方明确要求使用显式 git+https:// 形式，不要简写成 github:GanyuanRan/Aegis——部分 DSH/pnpm 组合会把简写解析成 SSH 协议，从而要求你为这个公开仓库配置 GitHub SSH 凭证：

dsh plugin --profile web add "git+https://github.com/GanyuanRan/Aegis.git"

headless profile 需要单独安装（一个 profile 的依赖不会自动在另一个 profile 生效）：

dsh plugin --profile headless add "git+https://github.com/GanyuanRan/Aegis.git"

2. 验证安装：先确认插件列表输出包含 aegis，再用 dump-config 确认只启用一行 aegis-method-pack：

dsh plugin --profile web list --depth 0
dsh --profile web --dump-config

dump-config 必须恰好包含一行 id: aegis-method-pack 与 name: aegis/extensions/dsh/index.js；profile 清单（默认 ~/.dsh/profiles/web/package.json）必须同时列出 dependencies.aegis 与 dsh.profile.bundles.aegis——只出现在 dependencies 里不算激活的 bundle。

3. doctor 复验：进入 aegis 包根目录（通常 ~/.dsh/profiles/web/node_modules/aegis）运行 doctor，且不要从目标项目目录运行：

cd <aegis-method-pack-root>
python scripts/aegis-doctor.py --write-config --json

JSON 输出必须包含 "ok": true、"workspaceSupport": "available"、"configStatus": "configured"。然后重启 profile，在会话里确认技能目录包含 using-aegis、systematic-debugging、verification-before-completion。

4. 更新 aegis：通过每个安装了 aegis 的 profile 的插件管理器更新：

dsh plugin --profile web update aegis

bundle 托管安装禁止使用 scripts/aegis-update.py——那个更新器只负责 direct-child 兼容模式。

5. 卸载 aegis：只从目标 profile 移除：

dsh plugin --profile web remove aegis

卸载后 dump-config 不得再包含 aegis-method-pack；卸载不会授权你删除 $DSH_HOME/skills 等目录。

aegis 典型用法

aegis 的典型用法是用自然语言声明目标与边界（Aegis goal）、开启决策访谈（Grill me）、按需启用 TDD 路由，并在需要时请求一阶原则审查；安装后默认自动激活，无需额外命令。（来源）以下四个步骤覆盖从声明目标到切换激活模式的日常用法。

1. 用 Aegis goal 声明目标：框定范围、成功证据与边界，把任务约束写清楚后发给代理。例如：

Aegis goal: Fix the auth refresh bug without rewriting the auth system.

2. 开启决策访谈：用 Grill me …（中文 审问我 …）让代理一次只询问一个决策，不规划也不实现。例如：

Grill me on whether we should ship a hosted version first.

3. 按需启用 TDD 路由：TDD 默认关闭，需要时可在提问里用 TDD Route: strict、test-first 等标记显式请求，或让 aegis 按任务风险自动选择严格、轻量或跳过。执行命令：

cd <aegis-method-pack-root>
python scripts/aegis-doctor.py tdd-mode auto

4. 切换激活模式与一阶原则审查：默认 auto 模式在会话启动、恢复、清理、压缩边界后自动注入引导；需要显式触发时切换为 explicit 模式，或用 aegis:first-principles-review 请求从第一性原理审查设计。执行命令：

python scripts/aegis-doctor.py activation-mode explicit

aegis 常见问题与排错

aegis 最常见的四类问题是 doctor 验证不通过、技能不触发、装错 profile 或清单缺 bundles、bundle 与 direct-child 同时激活，分别按验证三键、触发器链诊断、补清单与清理重复安装解决。（来源）

1. doctor 验证不通过：症状是 aegis-doctor.py 输出缺 ok、workspaceSupport、configStatus 三键之一；原因可能是从目标项目目录运行，或 profile 清单没有同时列出 dependencies 与 dsh.profile.bundles。解决：先 cd 进 aegis 包根目录再运行 doctor，并按验证步骤检查 ~/.dsh/profiles/web/package.json 的两处字段。 2. 技能不触发：症状是会话里注入的 Aegis 引导没有进入决策路径；原因是激活模式、宿主技能发现或任务匹配出了问题。解决：按触发器链依次检查——安装与版本可见性、宿主技能发现、激活模式、using-aegis 路由、任务到技能匹配、上下文压力，并显式请求加载 using-aegis：

dsh --profile web --dump-config

3. 装错 profile 或清单缺 bundles：症状是 dump-config 没有 aegis-method-pack 行；原因是一个 profile 的依赖不会自动在另一个 profile 生效，或包只出现在 dependencies 而未出现在 dsh.profile.bundles。解决：对目标 profile 单独执行安装命令，确认包名同时出现在两处。 4. bundle 与 direct-child 同时激活：症状是技能重复、路由证据不可靠；原因是两种安装视图同时存在，制造了重复的技能所有者。解决：只保留一种——bundle 托管安装禁止再用 scripts/aegis-update.py 注册 direct-child 视图。

适用场景与注意

aegis 适合所有希望 AI 编码代理先对齐基线、用证据证明完成的场景，但它当前是 Aegis Method Pack（runtime-ready），不是完整平台，也不构成最终完成权威，且 DeepSeek Harness 仍是 developer preview。（来源）

适用场景包括：代理频繁返工、项目所有者/契约/边界不清晰、需要跨 Codex、Claude Code、OpenCode、Kimi 等宿主保持同一套纪律、以及长任务中希望简单任务仍走 fast path。注意事项：

1. 当前状态是 Aegis Method Pack（runtime-ready），不是完整 Aegis Platform、守护进程或运行时核心；不提供权威 GateDecision、PolicySnapshot，也不代表最终完成权威。
2. 用户指令与目标项目规则永远优先于 aegis 的建议；宿主原生的技能目录、匹配器与执行策略仍由宿主掌控。
3. DeepSeek Harness 是 developer preview，兼容性破坏性变更在预期内，目前缺少 release 级实时路由证据。
4. 安装更新时按 profile 单独操作；bundle 托管安装不要混用 scripts/aegis-update.py 兼容模式。

项目链接

aegis 是 GanyuanRan 维护的 MIT 开源项目。 插件详情页：aegis 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：GanyuanRan/Aegis。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。