前言¶
用 DeepSeek Harness（DSH）做长任务开发时，常见痛点并不在「模型不够聪明」，而在流程失控：智能体还没摸清项目边界就改代码，改完一句「已完成」却拿不出验证证据，简单修 bug 也被拉成长篇流程。社区插件库 SkillHub 上有一款工作流类插件 Aegis（ganyuanran/aegis），GitHub 星标已逾 1100，维护者为 GanyuanRan。它把「基线优先、证据验证、漂移检查」做成可安装的方法包，目标很明确：少返工、改得更稳、别盲信「做完了」。
DeepSeek Harness 的核心理念是「一切皆插件」；SkillHub 等社区目录便于检索与安装，但与 DeepSeek / 幻方并无官方从属关系，下文安装方式以插件仓库与 GitHub 原文为准。
这是什么¶
Aegis 是一个 Aegis Method Pack（方法包），不是后台守护进程，也不是独立的运行时核心。一句话定位：让 AI 编程智能体在动手前先对齐项目真实基线（负责人、契约、边界），完工前用新鲜证据证明结果，简单任务走快路径，复杂任务才展开完整流程。
插件在 SkillHub 目录页标注为「工作流」分类，当前版本 v2.8.8；GitHub 仓库采用 MIT 许可证。项目自述源自 Jesse Vincent 的 Superpowers 思路，并在此基础上增加了面向真实软件项目的架构与证据层。
核心功能与亮点¶
1. 基线优先，减少盲目改动¶
智能体在改代码前会先对齐项目现状：模块归属、接口契约、改动边界。目标是停止「猜架构、猜约定」，从源头降低返工。
2. 证据验证，告别「感觉做完了」¶
完成声明需附带可核对的验证证据、覆盖范围与残余风险说明。用户读的是证据链，而不是一句口头确认。
3. 复杂度治理：简单任务不折腾¶
琐碎请求走 fast-path，只在任务风险确实需要时才展开完整仪式。README 将此称为 Workflow Quality：轻活保持轻，重活才加重流程。
4. 退役与漂移管理¶
对过时回退路径、废弃实现做跟踪或清理，避免「幽灵代码」在仓库里静默堆积；长任务中持续做漂移检查。
5. 多宿主一套方法¶
同一套纪律可在 Codex、Claude Code、OpenCode、Kimi 及 DeepSeek Harness 等支持 Skill 的宿主上使用。对 DSH 用户，官方文档 docs/README.deepseek-harness.md 提供了专门的 profile-plugin 安装与验证流程。
6. 可量化的基准参考（附边界说明）¶
项目在 Aegis 2.7.6 上做过冻结的 A/B 对照基准：在 20 个用例、120 次有效运行中，契约通过率从 61.67% 升至 93.33%，不安全结果从 13.33% 降至 0%。README 明确标注这是有界参考证据，不代表普适质量承诺或最终完成权威；评审为技术向、非独立人工审计。写文章时保留这一数据，同时保留其限定语。
安装与启用¶
安装前请确认本机已具备 dsh 与 pnpm（Harness 的 dsh plugin 会转发到 pnpm，仅能用 npx 启动 Web UI 并不足够）：
dsh --version
pnpm --version
默认方式：profile 插件 Bundle 安装¶
以 Web profile 为例，在每个需要启用 Aegis 的 profile 中单独安装（装在一个 profile 不会自动作用于另一个）：
dsh plugin --profile web add "git+https://github.com/GanyuanRan/Aegis.git"
若使用 Headless profile，需另行执行：
dsh plugin --profile headless add "git+https://github.com/GanyuanRan/Aegis.git"
需要固定版本时，可钉住 release tag：
dsh plugin --profile web add "git+https://github.com/GanyuanRan/Aegis.git#v2.8.8"
注意：官方文档要求使用完整的 git+https:// 形式，不要简写为 github:GanyuanRan/Aegis，部分 DSH/pnpm 组合会把简写解析为 SSH 路径，导致未配置 GitHub SSH 密钥时安装失败。
安装后不要在 $DSH_HOME/skills、项目 .dsh/skills 等路径重复注册，以免与 Bundle 产生重复 skill 所有者、干扰路由。
安装验证¶
先确认 profile 已列出 aegis：
dsh plugin --profile web list --depth 0
dsh --profile web --dump-config
dump 结果中应出现 id: aegis-method-pack。随后在方法包根目录（通常为 $DSH_HOME/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 后，在全新会话中确认 skill 目录出现 using-aegis、systematic-debugging、verification-before-completion 等条目，并用一条代表性自然语言任务验证路由是否进入 Aegis 决策路径。
兼容模式（仅在必要时）¶
当 preview 版 Bundle API 不可用、策略禁止第三方 profile 插件、或无法为插件管理器提供 pnpm 时，可使用文档中的 direct-child 兼容安装；该模式需用户显式批准，且不能与 Bundle 同时启用。一般用户优先走上面的默认 Bundle 路径。
典型用法示例¶
安装并重启宿主后，多数场景用自然语言即可，Aegis 会按任务匹配方法；需要更明确控制时可用下列触发方式。
日常诊断与修复：
Why does this login failure happen? Diagnose it before changing code.
Aegis goal: Fix the auth refresh bug without rewriting the auth system.
决策访谈（只问不改）：
Grill me on whether we should ship a hosted version first.
审查与第一性原理压测：
Review this diff independently before I merge it.
aegis:first-principles-review
显式 TDD（默认 TDD 模式为 off）：
TDD Route: strict
或在方法包根目录开启自动 TDD 路由：
cd <aegis-method-pack-root>
python scripts/aegis-doctor.py tdd-mode auto
更新已安装的方法包：
dsh plugin --profile web update aegis
也可用自然语言 update Aegis 或显式请求 aegis:update，由本地更新脚本按当前宿主路由。
对非平凡项目工作，Aegis 可被动复用 CONTEXT.md 或 CONTEXT-MAP.md 中的领域术语；领域建模仅在术语需解析、歧义、更名或冲突时激活，未决领域决策仍归用户所有。
适用场景与注意事项¶
适合谁、什么场景：
- 用 DSH 或其他 AI 编程宿主做跨多轮、多文件的改动，担心智能体「越改越偏」；
- 希望改动前先对齐架构与契约，完工前有可复查证据；
- 团队已在用 Skill / 方法包生态，希望一套工作流纪律跨宿主复用。
务必注意：
- 权限与信任边界：插件以当前
dsh进程权限运行，安装前应阅读源码与 MIT 许可证，确认符合团队安全策略。 - 非最终权威：Aegis 是 runtime-ready 方法包，不提供权威的
GateDecision、最终完成裁决；用户指令与目标项目规则优先于 Aegis 引导。 - DSH 仍为开发者预览：官方警告可能存在兼容性破坏性变更；文档记录的是已实现的 Bundle 结构支持，不承诺当前版本的实时路由质量已完全验收。
- 不要混装：Bundle 与 direct-child 兼容视图勿同时激活；项目级
.dsh/skills试验勿与同一 profile 的 Bundle 并行，以免路由证据不可靠。 - 激活模式：默认
auto会在会话边界延迟注入紧凑的using-aegis引导；若需纯显式调用，可在方法包根目录执行python scripts/aegis-doctor.py activation-mode explicit并重启宿主。
结尾¶
如果你厌倦了在长任务里「盯着智能体别乱改、别假完工」，Aegis 提供了一条可安装、可验证的路径：先对齐基线，用证据说话，让简单事保持简单。它不能替代你的工程判断，但能把常见失控点压进可复用的方法纪律里。
- SkillHub 目录页：https://www.skillhub.cn/plugins/GanyuanRan/Aegis
- GitHub 仓库：https://github.com/GanyuanRan/Aegis
- DeepSeek Harness 安装说明：https://github.com/GanyuanRan/Aegis/blob/main/docs/README.deepseek-harness.md
