跳到主内容

Aegis 使用指南

给 AI 编程助手加一层工作纪律:改代码前先读项目基线、报错先查根因、说"完成"要附验证证据,简单任务仍走快路径。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

Aegis

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:GanyuanRan/Aegis

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 更少返工。 agent 动手前先对齐项目真实基线(owner、契约、边界),
  • 更安全的改动。 冻结的 held-out A/B 实测:合同通过率
  • 说“完成”前先给证据。 每个完成声明都带 fresh 验证证据、覆盖范围与
  • 不留幽灵代码。 退役的 fallback 和旧路径会被显式跟踪或带退役触发条件
  • 简单任务保持简单。 平凡请求留在 fast-path,只有任务真正需要时才展开

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装完立刻就能用吗?

需要重启对应 DSH profile 才会生效。安装说明要求先用 dsh plugin list 和 dsh --dump-config 回读,确认出现 aegis-method-pack 一行后再重启会话。

装上以后每个问题都会走一大套流程吗?

不会。路由规则要求 Agent 对简单任务直接声明走快路径,只有涉及多步实现、共享模块、契约变更等风险较高的任务才展开完整方法。

它会往我的项目里写文件吗?

默认不写。只有当工作流需要留存基线、计划、检查点或证据时,才在目标项目的 docs/aegis/ 目录下按需创建记录,普通问答和小改动不产生文件。

默认会强制我写测试吗?

不会,TDD 模式默认为 off。需要时可运行 aegis-doctor.py tdd-mode auto 打开按风险自动路由,或在提问里直接写 strict TDD、test-first。

在 web profile 装了,headless profile 也能用吗?

不能。DSH 的插件依赖按 profile 隔离,需要在每个要用的 profile 下分别执行一次安装命令。

怎么卸载?

对目标 profile 执行 dsh plugin remove aegis,然后用 dsh --dump-config 确认输出里不再含 aegis-method-pack 一行即可。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+(以可选 peerDependencies 形式声明)
  • Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则