Erstan Agent Tools Beta

面向 AI 编码代理的临时 Erstan Beta 集成。本仓库打包了一个通用插件，将 Beta 用户连接到 Erstan 的隔离 QA 环境，并提供针对构建、审查和优化 Agents 与 Skills、运行操作以及处理授权工作区内容的聚焦指令。

Beta 环境： 此插件中的数据与 OAuth 授权与生产环境分离。当你的工作区迁移后，请安装生产版 erstan 插件。届时本仓库将被停用。

该插件不包含 Erstan API 密钥。每位用户通过其 AI 宿主以 OAuth 方式登录 https://api-qa.erstan.com/v1/mcp。Erstan 服务端的 Beta 访问策略仍然是访问边界；仓库可见性并不授予产品访问权限。

包含内容

• erstan-agent-builder — 创建、修订、验证、测试和发布 Agent 图。

• erstan-agent-optimizer — 检索现有 Agent 并生成最小化的版本关联优化提案。

• erstan-agent-review — 审查 Agent 定义并基于持久化证据诊断运行。

• erstan-run-operator — 启动已发布的 Agents，并安全处理等待、审批和追踪。

• erstan-skill-manager — 管理完整、带版本的 Erstan Skill 包。

• erstan-skill-optimizer — 检索完整的工作区 Skill 包并进行优化，不丢失业务规则、文件或操作元数据。

• erstan-work-manager — 处理已授权的任务、项目、文档、文件夹和文件。

概念性的 agent:optimize 和 skill:optimize 操作以 $erstan-agent-optimizer 和 $erstan-skill-optimizer Skills 的形式分发。它们不是 npm CLI 命令。默认情况下，它们止步于有证据支持的本地提案和验证结果；更新、实时 Agent 预览和发布均需分别获得明确的单独授权。

Related MCP server: mcp-testing-tools

权限模型

Erstan 是连接可访问内容的唯一权威来源。用户可在 Settings > Connected apps 中管理已连接的应用、工作区范围、允许的工具族、项目或团队白名单，以及 Erstan 侧的审批策略。

初始授权默认为推荐的 Build 配置文件。它包含 View agents、Build agents、Run agents、Publish agents 以及只读的 View runs、View work、View documents 和 View files 权限。它不允许任务、文档或文件写入。如需只读访问，请使用 Review。如需写入，请使用 Custom 并配合适用的 Manage work、Edit documents 或 Edit files 权限，或选择 Full access。

用户可在 Settings > Connected apps 中管理和撤销连接。缩减访问权限会立即生效。增加权限或切换到更宽泛的配置文件需要明确的 OAuth 重新授权，这样后台代理就无法自行扩大其授权范围。

Claude、Codex、ChatGPT 或其他 MCP 宿主拥有本地连接会话及其自身的确认控制权。宿主可以缩小访问范围或要求额外确认，但不能授予 Erstan 已拒绝的权限。在 Erstan 中撤销连接会使该连接对所有使用它的宿主会话失效。

这种两层模型使权限易于理解：

1. Erstan 决定最大授权的数据和操作。

2. AI 宿主决定是否在该边界内调用某个操作。

在 Codex 中安装

erstan-beta@erstan-beta 表示 plugin-name@marketplace-name；它不是账户 ID 或密钥。

codex plugin marketplace add erstanai/erstan-agent-tools-beta
codex plugin add erstan-beta@erstan-beta

打开新的 Codex 会话，使用 /plugins 确认安装，在提示时连接 erstan-beta MCP 服务器，并完成浏览器登录。该插件使用 plugins/erstan-beta/.mcp.json 中的远程服务器配置。

在 Claude Code 中安装

claude plugin marketplace add erstanai/erstan-agent-tools-beta
claude plugin install erstan-beta@erstan-beta

运行 /reload-plugins，然后运行 /mcp 连接 erstan-beta 并完成 OAuth。Claude Code 发起远程 MCP 授权；插件不会要求用户粘贴 bearer token 或 API 密钥。

在 Claude Cowork / Desktop 中安装

打开 Customize > Plugins > Browse plugins，选择 Add marketplace，然后输入：

https://github.com/erstanai/erstan-agent-tools-beta

安装 Erstan Beta 并在提示时完成浏览器登录。插件在 Claude Cowork 和 Claude Code 中可用，而非标准 Claude Chat 界面。

更新或移除

使用宿主的插件浏览器更新、禁用或卸载 Erstan Beta。移除本地插件不会撤销现有的 Erstan OAuth 授权。请在 Erstan 的 Settings > Connected apps 中查看或撤销授权。

已发布的版本和校验和可从 GitHub Releases 获取。

ChatGPT 及其他宿主

此临时 Beta 仓库未提交到通用 ChatGPT 和 Codex 插件目录。它有意不包含 .app.json：OpenAI 应用映射必须使用发布时分配的真实注册 plugin_asdk_app... 或 asdk_app_... 标识符。分发边界请参阅 Publishing。

其他 MCP 客户端可以直接连接到：

https://api-qa.erstan.com/v1/mcp

部署的服务器必须暴露符合标准的 OAuth 发现和授权。此分发中没有静态密钥回退方案。

本地验证

要求：Node.js 20 或更高版本、Python 3，以及可选的 Claude Code（用于其原生验证器）。

npm run verify
python C:/Users/<you>/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/erstan-beta
python C:/Users/<you>/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/erstan-beta/skills/erstan-agent-builder
claude plugin validate .

对 plugins/erstan-beta/skills 下的每个目录各运行一次 skill 验证器。CI 运行仓库自有的发布验证器；原生 Codex、Skill 和 Claude 验证器仍然是必需的发布门禁，因为它们的可用性和模式分别由各自的宿主拥有。

从生产环境同步

Beta 分发版源自经过审查的生产环境检出，并带有明确的身份和端点转换。本地运行：

npm run sync:production -- --source ../erstan-agent-tools

该命令复制生产版 Skills 和资源，对齐插件元数据，保持独立的 erstan-beta 身份，并将托管的 MCP 端点重写为 https://api-qa.erstan.com/v1/mcp。手动 Sync production distribution GitHub Actions 工作流执行相同的转换，验证结果，并打开拉取请求以供审查。它不会发布或合并 Beta 版本。仅当需要更高的预发布版本号时才传递 --version；版本必须保持为生产版本的预发布版本。

工具包分离

本仓库是小型、可安装的最终用户分发版。维护者 CLI 工具和离线诊断夹具属于独立的 erstan-agent-toolkit 仓库，不得复制到插件发布中。

许可证

Apache License 2.0。请参阅 LICENSE。