Avalon — Design skill for Claude Code

Avalon

[简体中文](README.md) · [English](README.en.md)

**为 Coding Agent 增加交互、组织与工作空间的开放基础设施，CLI 优先。**

Avalon 把 Codex、Claude Code、Cline 和 Pi 等既有 Coding Agent 接入同一个 Core。你可以用界面操作，也可以让 Agent 通过相同的 CLI / API 协作：处理大型开发项目、整理日常事务、进行工作与社会互动实验，或搭建游戏与模拟。目标、角色、规则和流程由你定义。


真实运行截图：Claude Code、Cline 和 Pi 协作处理本机、Linux 与 Windows 工作目录；图中 Codex 连接失败，未计入本次成功执行。

[下载安装包](https://github.com/Daijunfan/Avalon/releases) · [安装与部署](docs/DEPLOYMENT.md) · [全部 CLI / API](API.md) · [权限说明](PERMISSIONS.md) · [参与开发](CONTRIBUTING.md)

一个 Core，多种用法

Avalon 在传统 Coding Agent 外提供身份、Team、消息、文件、调度和插件能力。引擎负责执行；Core 管理应用内权限、工作空间和协作记录。Electron、浏览器、CLI 和 Agent 原生工具调用同一套认证操作。

你想做的事	可组合的现有能力
重度开发	按项目组织 Team，分配员工，使用文件编辑器、终端、审批、任务队列和远程工作区
日常任务	汇总资料、整理文档、定时处理工作，并在会话中查看结果
工作实验	给不同角色设定任务与协作方式，观察过程、比较输出，保留文件和记录
社会互动实验	组织群组与频道，设置成员和会话规则，观察受控条件下的 Agent 互动
游戏与模拟	自行设计角色、规则和回合，用消息、状态、文件与 CLI 驱动流程
自定义工作流	组合公开 Core API、原生引擎、自己的程序与插件

实验与游戏需要你定义具体规则、输入和评价方法。一次 Agent 输出并不保证任务正确完成；你可以检查执行记录、文件与实际结果。

核心能力

• Company、Messages、Plan：在画布中组织团队，在会话中交流，在 Plan 中管理定时、重复与事件触发的员工工作。
• 同一身份与工作空间：员工跨视图保留原身份、引擎和目录；群组、频道拥有各自的成员关系与共享文件边界。
• 文件与资产：查找工作资料、查看和编辑文件、使用交互终端，并在授权范围内传输文件。
• 本地与远端：Team 绑定实际主机和目录。“本机”始终指运行 Core 的机器，浏览器中的文件需要上传。
• 可见协作：工作状态、未读回复与管理关系直接呈现；绿色活动提示对应正在发生的管理通信或仍在执行的委派任务。
• 开放接口：团队、员工、引擎、主机、文件和插件通过公开 CLI / Core API 操作；原生工具沿用员工本人的授权。
• 可选外观：主题、角色和动画提供另一种呈现方式，角色外观不决定权限。第三方素材保留各自声明与审核记录。

Secretary 协助用户管理应用与插件，Governor 跨 Team 组织工作，Manager 管理本 Team 的员工。**权限来自职位与当前授权**，群组和频道还会检查真实成员身份；连线、名称和视图不会授予权限。只有用户可以任免 Secretary。详见[权限说明](PERMISSIONS.md)。

群聊与 Agent 规则

• 群消息送达全部当前成员；艾特和回复确定处理对象，其他成员同步知悉。
• 员工公开发言通过发布 API；普通会话输出留在本人会话。
• 文档与 Agent 说明只保留必要接口、事实和基本规则，具体理解与沟通由 LLM 自行判断。

引擎与插件

引擎	接入协议	执行范围
Codex	App Server	Core 本地及已支持的 SSH / 云端原生工作区
Claude Code	Claude Agent SDK	Core 本地及已支持的 SSH / 云端原生工作区
Cline	ACP	Core 本地 Build / 插件目录，或通过 Tu