Aegis

环境要求

• 一个已安装的 AI 编程宿主（如 Claude Code、Codex 或官方 DeepSeek Harness `dsh`）
• 本机 Python 环境（需运行 scripts/aegis-doctor.py）
• git，且网络可访问 GitHub
• 已定位到 Aegis 方法包（method-pack）根目录

安装与启动步骤

1. 1确认宿主环境

   先确认自己用的是哪个 AI 编程宿主（Claude Code、Codex 或 dsh），并确保本机有 Python 和 git。

2. 2交给智能体安装

   把 README 的 Quick Install 提示词原样发给你的 AI 编程智能体，让它识别宿主并按对应指南全局安装。

   Read https://github.com/GanyuanRan/Aegis, identify my current AI coding host, and install Aegis globally using the correct host guide. If the host is the official DeepSeek Harness (`dsh`), treat global/minimal installation as native profile-plugin installation with `dsh plugin --profile <profile> add "git+https://github.com/GanyuanRan/Aegis.git"`; do not silently substitute the direct-child compatibility path unless the plugin manager is unavailable and I explicitly approve compatibility mode. Restart or reload the host if needed, then run complete-install verification from the installed Aegis method-pack root. Do not run the doctor command from the target project directory. First locate `<aegis-method-pack-root>`, then run `cd <aegis-method-pack-root> && python scripts/aegis-doctor.py --write-config --json`. Treat the install as complete only if the JSON includes `"ok": true`, `"workspaceSupport": "available"`, and `"configStatus": "configured"`; if the host uses a separate skill discovery directory, also verify it with `--discovery-root <path>`; if the host guide declares a skill directory name prefix, also pass `--discovery-name-prefix <prefix>`. Also complete the selected host

   复制

3. 3dsh 宿主原生安装

   若宿主是官方 DeepSeek Harness，用插件管理器做原生 profile-plugin 安装，而非兼容路径。

   dsh plugin --profile default add "git+https://github.com/GanyuanRan/Aegis.git"

   复制

4. 4进入方法包根目录

   先定位 aegis-method-pack-root，再切换进去；绝对不要在任何目标项目目录里执行 doctor。

   cd /your/path/to/aegis-method-pack

   复制

5. 5运行 doctor 校验

   在方法包根目录执行 doctor 并写出配置，以 JSON 输出结果判断安装是否完整。

   cd /your/path/to/aegis-method-pack && python scripts/aegis-doctor.py --write-config --json

   复制

6. 6补充发现目录校验

   宿主若使用独立的 skill 发现目录，或指南声明了目录名前缀，追加对应参数再校验一次。

   cd /your/path/to/aegis-method-pack && python scripts/aegis-doctor.py --write-config --json --discovery-root /your/path/to/skills --discovery-name-prefix your-prefix

   复制

7. 7重启并激活

   重启或重新加载宿主，并按所选宿主指南完成原生激活与自动入口检查，仅文件被发现不算完成。

关键配置

如何确认成功

doctor 的 JSON 输出同时包含 "ok": true、"workspaceSupport": "available"、"configStatus": "configured"，才算安装完整。

常见问题

注意事项

• 不要静默把 dsh 的原生安装替换成 direct-child 兼容路径。
• 仅文件被发现或通用 doctor 结果通过还不够，需完成宿主的激活与自动入口检查。
• 命令中的 default 为 profile 示例名，请替换为你实际使用的 profile。
• 安装后按需重启或重新加载宿主。