Aegis

Name: GanyuanRan/Aegis
Author: GanyuanRan

GanyuanRan/Aegis

面向编码 Agent 的软件工程方法包，提供基线优先规划、系统化调试、提示词卫生、完成前验证，以及修复/退役双轨跟踪技能。

1,26362PythonMIT源码

安装

把 Aegis 装进 DeepSeek Harness

GitHub 方式 · GitHub 源码

从 GitHub 装会执行项目自己的构建脚本，而 pnpm 默认拦着不让跑——先跑一次这条命令，pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。

我们跑过之后

我们跑过，装得上

这里每条命令都在一次性容器里、对着干净 profile 真跑过，结果取自 harness 自己的记录，不是读源码猜的。最近一次 7 天前.

挂进你的 README

给维护者的：badge 取这条 listing 最近一次 sandbox 实测的结果，重跑之后它自己会变，读者点开就是这页的完整记录。

安装前须知

装 Aegis 之前，先看这几条

源码在这里： GanyuanRan/Aegis——已进入社区精选库，DSH 自带的插件市场就是从这儿装的。
开源协议：MIT。
自动识别到：终端执行。授权之前请先读一遍源码。
被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。

AI 锐评

是什么 — Aegis 是一个 coding agents 的软件工程方法包。

谁该装 — 在使用 DeepSeek Harness 进行复杂 coding 任务时，需要 baseline-first planning 能力的开发者适合安装 Aegis。如果只做简单请求且无需 verification before completion，用户可以不安装它。

注意 — Sandbox 测试通过：在全新 profile 里装上，并被 harness 注册进 profile。没发现明显的坑。

锐评 — 我会装它，因为它提供了 verification before completion 的支持，这在需要 proof before "done" 的 coding 任务中值得。

grok-4.6 写的，只当参考，不当结论。里面说装得上或装不上，是在干净 profile 里真跑过的；其余都是读仓库读出来的。以实际运行为准。

Aegis 是做什么的

Layered blocks flow through checks into a verified form, with discarded fragments separated.

Aegis 是一个 DeepSeek Harness 插件，为编码 agent 提供一套软件工程方法：基线优先规划、系统化调试、提示词卫生、完成前验证，以及修复与退役的双轨跟踪。它不是新的代码执行工具，而是把这些规则投射到支持技能的宿主中。开始修改前，agent 需要先对齐项目真实基线，包括所有者、契约和边界；宣称完成前，要给出新鲜的验证证据、说明覆盖范围并记录剩余风险。旧 fallback 和旧路径则应关联退役触发条件，避免成为无人跟踪的技术债务；简单任务仍可走快速路径。

它适合需要明确规划和可审计证据的编码工作流。如果宿主不能加载 skill，或现有流程已经提供同等的规划与验证机制，安装 Aegis 的收益有限。README 还要求完成宿主原生激活和自动入口检查，不只确认文件已发现。

检测到的终端风险来自验证流程：插件会通过终端运行 python scripts/aegis-doctor.py --write-config --json，并可使用 discovery 参数检查安装、配置和 workspace 支持，因此实际触达范围取决于 agent 在当前环境中的终端权限。

Aegis 的文档

行为说明

Aegis 将方法包投射到支持 skill 的编码宿主中，覆盖基线优先规划、系统化调试、提示词卫生、完成前验证，以及修复/退役跟踪。基线应包含项目所有者、契约和边界；完成声明应带有新鲜证据、覆盖范围和剩余风险。简单请求可以继续走快速路径。

命令

README 要求先定位 <aegis-method-pack-root>，再在该目录执行：

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

只有 JSON 同时包含以下结果，安装才算完成：

字段	要求值
`ok`	`true`
`workspaceSupport`	`available`
`configStatus`	`configured`

--write-config 写入 doctor 流程使用的配置，--json 输出机器可读结果。不要在目标项目目录运行 doctor。

宿主激活

官方 DeepSeek Harness（dsh）应使用原生 profile-plugin 安装方式：dsh plugin --profile <profile> add github:GanyuanRan/Aegis。只有在 plugin manager 不可用且明确批准 compatibility mode 时，才使用 direct-child compatibility 路径。宿主若定义了 plugin、hook 或 session-start bootstrap contract，还必须完成原生激活和自动入口检查。

发现参数

宿主使用独立 skill discovery 目录时，额外传入 --discovery-root <path>；宿主指南规定目录名前缀时，再传入 --discovery-name-prefix <prefix>。README 提到 Codex、Claude Code、OpenCode 和 Kimi 等支持 skill 的宿主。

根据项目自己的文档整理，会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README

同一分类