§03 一个目录就是一个 Agent

03.1 filesystem-first 是什么

Eve 的第一个特点是 filesystem-first（文件系统优先）。官方一句话："The filesystem is the authoring interface"。

翻成白话：别把 Agent 藏在某控制台的一堆配置项里，把它当成普通软件项目来管理。

最小项目长这样：

my-agent/
└── agent/
    ├── agent.ts          # 模型与运行时配置（可选）
    ├── instructions.md   # 常驻系统提示（必需）
    ├── tools/            # 类型化工具
    ├── skills/           # 按需加载的操作手册
    ├── channels/         # HTTP、Slack、Discord 入口
    ├── subagents/        # 可委派任务的子 Agent
    ├── sandbox/          # 隔离执行环境配置
    ├── connections/      # 外部 MCP/OpenAPI 连接
    ├── schedules/        # 定时任务
    ├── hooks/            # 生命周期钩子
    └── lib/              # 共享代码

最小的 Agent，甚至可以从一份 instructions.md 开始。

03.2 为什么这设计舒服

因为 Agent 的角色、工具、技能、入口都落在普通文件里，它们就能：

• 进 Git 做版本管理；
• 走 Pull Request 审查；
• 看 instructions 改前改后的 diff；
• 对不同版本建 Preview 环境；
• 出问题时回滚到上一个提交。

维度	控制台配置型平台	Eve 文件型	标叔的结论
版本管理	导出导入 / 无	Git 原生	文件赢
审查	截图或录屏	PR diff	文件赢
回滚	手动备份	git revert	文件赢
上手成本	低	需会 TS/Markdown	平台略赢
多环境	平台功能	Preview 分支	平手

重点看"版本管理"那行。Agent 也是一种软件，该用软件的方式管。

03.3 默认就给你的能力

你以为只写了两份文件？其实 Eve 默认 harness 已经给了 Agent 四类工具：文件、Shell、Web、委派。所以哪怕不加任何工具，Agent 也能读文件、跑命令、搜网页、调子 Agent。