Autonomous Agent Manifest Specification

Every
Agent.
One File.

AI 智能体不会遗忘——但项目知识属于工具,而不属于项目本身。 AAMS 给你的仓库赋予记忆、结构和连续性。 一个文件。没有框架。没有工具锁定。

bash — 第 1 步,共 1 步
$ curl -sO https://raw.githubusercontent.com/DEVmatrose/AAMS/main/.agent.json
1
文件
0
依赖项
8+
兼容工具
有上下文的会话
40s
安装时间

你的智能体会忘记。
你的项目也会。

切换工具——第 47 次会话就消失了。更换团队成员——上下文随之流失。 问题不在于智能体会遗忘,而在于项目知识不属于项目本身。

🔄
工具锁定

会话持久性存储在工具的云端,以其格式存储,绑定于其生态系统。切换工具——一切从零开始。

🌀
上下文漂移

5 次会话时你记得一切。50 次时你重新决定两个月前已决定的事。100 次时智能体开始产生幻觉。

👻
部落知识

"问问张伟,他知道。" 仓库无法自我表达。没有审计跟踪。没有可追溯的决策记录。

"没有智能体结构的仓库就像没有航海日志的船。每个人都知道昨天做了什么,没有人知道之前发生了什么。"

核心循环

AAMS 不是工具,不是运行时,也不是框架。 AAMS 是智能体的结构化上下文与决策编译器—— 封装在仓库根目录的一个文件中。

输出
文档记录
决策
记忆
新上下文
📋
工作纸

每次会话都是 WORKING/WORKPAPER/ 中的一个 Markdown 文件。带时间戳,可搜索,永久保存。

🧠
长期记忆

ltm-index.md 跨会话积累上下文。智能体在行动前先查询记忆。

⚖️
决策日志

每个架构决策都可追溯。git log + grep WORKING/ = 完整审计跟踪。

一个文件。
包含一切。

.agent.json 放入仓库根目录。 读取此文件的智能体立即知道它需要的一切。

📄 .agent.json AAMS/1.0
工作区契约 — 文档放在哪里,会话如何结构化
记忆路由 — 长期记忆存储在哪里,如何查询
引导规则 — 智能体首次启动时应做什么,on_session_start,on_first_entry
权限范围 — 可以做什么,不能做什么。不是演员,是确定性工作者。

每个工具都有自己的约定。AAMS 用一个桥接文件取代它们所有。 不需要 CLAUDE.md,不需要 GEMINI.md,不需要 airules.md。

🌉
AGENTS.md
被所有主流 AI 工具读取——Copilot、Cursor、Claude Code、Codex、Windsurf
📖
READ-AGENT.md
项目上下文与智能体契约——完整的项目状态
⚙️
.agent.json
引导规则和工作区结构——机器可读
Copilot Cursor Claude Code Codex Windsurf Aider Continue.dev Firebase Studio

使用 AAMS 的项目

从自主智能体框架到节日网站。 这些项目展示了当仓库能够自我表达时的可能性。

→ 查看展示列表并添加你的项目

你使用了
AAMS

什么有效?什么无效?使用了哪个工具,会话规模多大,什么项目? 来自实战的真实报告让这个标准更完善。

⚑ 以 Issue 形式提交报告

// 我们感兴趣的内容

01 工具与配置:你使用了哪个智能体,什么项目配置?
02 哪些有效:AAMS 在哪里带来了真正的价值?
03 哪些缺失:边缘情况、缺失字段、不明确的规则?
04 你的仓库:可选——可直接添加到案例展示列表。

40 秒。
一个文件。

无需 npm install,无需 pip install,无需框架。

01
获取文件
curl.agent.json 直接下载到你的仓库根目录。 就这样,一个文件。
02
告诉智能体
告诉智能体:Read .agent.json and execute agent_contract.on_first_entry. 无需进一步配置。
03
智能体开始工作
智能体创建 WORKING/,扫描仓库,写下第一份工作纸。完成。
第 1 步——你需要的唯一文件
$ curl -sO https://raw.githubusercontent.com/DEVmatrose/AAMS/main/.agent.json