Aegis

Name: GanyuanRan/Aegis
Author: GanyuanRan

GanyuanRan/Aegis

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

1,02446PythonMIT源码

安装

把 Aegis 装进 DeepSeek Harness

npm 方式

直接拉已发布的 tarball，不用克隆整个仓库，也不需要额外配置。如果你用的是别的 profile，把 `web` 换成对应的名字。

GitHub 方式 · npm 包

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

安装前须知

装 Aegis 之前，先看这几条

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

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

同一分类