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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则