分享一个极简的AI Agent框架：SwarmVault

很多Agent框架容易陷入一个误区：功能堆砌。每增加一个Skill看似在增强能力，实则在吞噬上下文窗口，最后反而让模型变得迟钝。我一直在找一个足够轻量、能完全在脑中构建出逻辑图谱的框架，没找到，于是自己写了一个。

这个框架的核心逻辑是“克制”，它只保留了13个经过精简、无重复的核心技能。

实操部署

直接通过命令行快速安装：

git clone https://github.com/AnmarHani/swarmvault && cd swarmvault && ./install.sh

核心技术点分析

• 基于规格（Spec）而非感觉： 很多Agent生成的代码或文档充满了冗余的“仪式感”。SwarmVault 强制执行从需求访谈 → SRS文档 → 决策记录 → 依赖排序的任务单流程。强模型会在每个里程碑进行审计，确保输出结果是干货，而非填充物。
• 零依赖的Vault存储： 采用纯文件夹结构（如 10 Projects, 20 Memory 等），Agent 记录的所有信息都是本地 Markdown。这意味着你可以随时开启新会话，只要说一句“继续项目X”，它就能通过 query 和 sync 脚本找回之前的状态。
• 多模型动态调度： 这是一个可选功能。它可以根据任务特性，在 Claude Code、Cursor 或 Codex 之间分配工作，同时兼顾各平台的 Usage Limit。

适用场景与局限

• 适用人群： 厌倦了复杂配置、追求本地化存储、需要多 Agent 协作且不希望被托管服务绑定的开发者。
• 环境支持： Linux/macOS/WSL 是原生支持，Windows 兼容性一般。
• 舍弃的功能： 没有可视化看板，没有云端托管，也没有复杂的插件系统。

对我来说，一个好的框架应该是能在一下午时间内全部读完代码并完全信任的。SwarmVault 正是为此设计的。

具体代码实现可以参考：

https://github.com/AnmarHani/swarmvault