eve Skill 技能

是什么

eve 是 Vercel 出品的文件系统优先（filesystem-first）持久化后端 AI Agent 框架。开发者以磁盘上的目录来编写 Agent，Markdown 负责人类需要阅读的规范说明，TypeScript 负责需要类型约束和运行时行为的逻辑。框架内置 MCP 工具、Subagent、Channel、Session 等核心抽象，支持在 Vercel 基础设施上部署持久化运行的 Agent。

核心能力

eve 的核心能力建立在三个设计原则之上：

文件系统即契约 — Agent 的目录结构本身就是规范。instructions.md 定义始终生效的系统提示，tools/ 目录放置可执行的工具集成（Typed Tool），skills/ 目录放置按需加载的命名技能，channels/ 定义消息入口和投递策略，connections/ 连接外部 MCP Server。

持久化会话 — Agent 的每次运行都是可恢复的（Sessions and Runs），sessionId 在整个生命周期内不可变，后续消息基于该 ID 恢复上下文，而非重新发起。运行时基于 Nitro + Workflows，天然具备 Vercel 级别的持久化保障。

稳定 HTTP 协议 — 框架暴露一个基于不可变 sessionId 的公开 HTTP 协议，任何外部系统均可基于该协议与 Agent 通信，无需感知内部实现细节。

安装与快速上手

npx eve@latest init my-agent

初始化命令会创建一个完整的 Agent 目录骨架，安装依赖并启动开发服务器。指定模型：

eve init --model openai/gpt-5.4-mini
eve init --channel-web-nextjs

主要 CLI 命令：

• eve dev — 本地运行时 + REPL
• eve build — 编译 .eve/ 产物
• eve start — 启动构建产物
• eve info — 查看 Agent 发现结果

目录结构与创作模型

eve 的每个 Agent 遵循固定目录结构，通过 define* 辅助函数在各自子路径导入使用：

• defineAgent() — agent.ts
• defineTool() / defineBashTool() — tools/.ts
• defineSkill() / getSkill() — skills/.ts
• defineChannel() — channels/.ts
• defineSandbox() — sandbox.ts
• defineSchedule() — schedules/.ts

内置运行时访问器：getSession() 获取当前会话上下文，getSandbox() 获取沙盒句柄，getSkill() 加载命名技能，getContext() 系列函数管理上下文数据。

部署

eve 构建在 Nitro + Workflows 之上，具备天然的高可用性。预览版本适用 Vercel Beta 条款，正式发布前框架和 API 可能调整。

评估

eve 适合：构建需要持久化运行的后端 AI Agent；用 Markdown 管理 Agent 指令规范同时保留 TypeScript 灵活性的团队；深度使用 Vercel 基础设施且需要稳定 Agent 运行时保障的项目。

资源

• GitHub（4709⭐）：https://github.com/vercel/eve
• npm：https://www.npmjs.com/package/eve
• 文档：https://eve.dev/docs