Agestra

面向 Claude Code、Codex CLI、Gemini CLI 和本地模型的多宿主 MCP 编排工具。

English | 한국어 | 日本語 | 中文

Agestra 用来让多个 AI 从不同角度审视同一个问题，并把结果整理成证据清晰的结论。它适合代码审查、QA、安全检查、设计讨论、想法探索和基于证据的共识。

快速开始

先在你已经使用的宿主里安装 Agestra。

| 宿主 | 安装 | |------|------| | Claude Code | 先执行 /plugin marketplace add mua-vtuber/Agestra，再执行 /plugin install agestra@agestra | | Codex CLI | 先执行 npm install -g agestra，再执行 agestra-install codex --assets --scope user | | Gemini CLI | 先执行 npm install -g agestra，再执行 agestra-install gemini --assets --scope user |

安装后，打开项目并发起 Agestra 工作流。

• Claude Code: /agestra research ... 或 /agestra review ...
• Gemini CLI: /agestra:research ... 或 /agestra:review ...
• Codex CLI: 像 Use Agestra with Gemini and Codex to review this branch. 这样明确提到 Agestra 或多个 AI

第一次运行时，它可能会询问你要启用哪些 provider。只有一个 provider 也能完成设置和宿主自有流程，但 Multi-AI 比较在两个以上 provider 时效果最好。

用它做什么

• research: 由当前宿主单独收集并整理 idea、QA 或安全问题所需的证据。外部 provider 不参与这个调查流程。
• review: 围绕已有代码、文档、diff 或已准备好的 research 结果进行讨论并比较意见。review 不会启动新的调查。
• review 视角可以覆盖代码质量、回归风险、UX、整理点、设计契合度、性能、可靠性、测试、安全异味和上线准备度。

运行时会发生什么

1. Agestra 检查设置和可用 provider。
2. 它把请求整理成目标和范围明确的工作流。
3. 在 research 中，当前宿主负责调查、整理并文档化证据。没有 provider fan-out。
4. 在 review 中，被选中的 provider 讨论范围内的代码、文档、diff 或已准备好的 research 结果。它们不会另行调查。
5. Agestra 返回一份包含结论、分歧和证据的结果。

普通的 review 或 QA 请求不会自动变成 Agestra 工作流。只有当你使用 /agestra ...，或者明确要求多 AI / provider-backed 的 research/review 工作时，Agestra 才会启动。

代码修改应优先由当前宿主直接完成。Agestra 最适合在修改之后审查结果、按计划验证、比较多个 provider 的意见，并记录证据。

在这个仓库里使用

如果你 clone 了这个仓库，想测试当前 checkout：

npm install
npm run bundle

然后按宿主执行安装：

npm run install:claude
npm run install:codex
npm run install:gemini

这些命令会注册当前 checkout 并安装 helper assets，不会把 npm 包装成全局安装。

如果你想让当前 checkout 像真正的全局包一样工作：

npm run bundle
npm install -g .
npm run install:codex:global

Gemini 使用 npm run install:gemini:global。

进一步文档

• commands/: 工作流规范

开发

npm run build
npm test
npm run bundle
npm run lint

卸载

Claude Code:

/plugin uninstall agestra@agestra

Codex CLI:

npm run uninstall:codex
npm run uninstall:codex:assets

Gemini CLI:

npm run uninstall:gemini
npm run uninstall:gemini:assets

如果还想删除生成的项目数据，请手动删除 .agestra/。

许可证

GPL-3.0