【免费下载链接】agent-mdProduction-grade agent directives for autonomous coding agents: Claude Code, Codex, Cursor, Windsurf, Aider.项目地址https://gitcode.com/gh_mirrors/cla/agent-md点击查看免费下载如果你正在使用 Claude Code、Codex、Cursor 或 Windsurf 等 AI 编码 Agent大概率遇到过同一个痛点关掉窗口再打开它就像失忆了一样——不知道上次做到哪、忘了你纠正过的错误。agent-md 是一个生产级编码 Agent 规范工具它的 5 文件记忆系统memory/ 目录用五个 Markdown 文件给 Agent 装上了长期记忆实现跨会话状态延续、任务进度可追溯、错误不重犯。为什么 AI 编码 Agent 会失忆Agent 的记忆分两层很多人搞混了记忆类型存在位置特点短期记忆聊天记录上下文窗口会话一结束就丢失超长对话还会被截断长期记忆仓库里的文件持久保存每次会话可重新读取agent-md 的核心规则写得很直白Chat history is not durable memory聊天记录不是持久记忆。所以它要求 Agent 在每次会话开始时主动读取记忆文件工作过程中随时更新它们。这个设计就定义在 AGENT.md 的 Persistent State 章节。5文件记忆系统各司其职的五份档案安装 agent-md 后项目根目录会出现memory/目录里面有五个文件。它们的分工可以用一句话概括一个管环境、一个管设计、一个管进度、一个管验收、一个管教训。1️⃣ agents.md —— 环境与工具登记册memory/agents.md 记录项目当前的硬件配置活跃子 Agent可以委派任务的子代理有哪些MCP / 外部服务Agent 能调用哪些外部工具如 Playwright 截图、数据库 MCP技术栈运行时版本、语言、框架、测试与 Lint 工具禁用模式项目里明确不许写的代码写法它相当于新会话的入职手册避免 Agent 每次都要重新问一遍这个项目用什么框架。2️⃣ plan.md —— 宏观设计与垂直切片memory/plan.md 存放架构级的设计决策核心是垂直切片Vertical SlicesCurrent Phase当前所处阶段Vertical Slices每个切片对应一个用户可见的成果包含 UI、API、数据、测试、验收五要素Deferred / Out of Scope明确现在不做什么防止范围蔓延Open Questions实现前必须和人确认的模糊点它的作用是防漂移——Agent 不会在写了一半功能时突然跑去改数据库结构因为设计方向已经白纸黑字写在文件里了。3️⃣ progress.md —— 原子进度日志时间锚点memory/progress.md 是整个记忆系统里最刚性的文件它把自己称为Your temporal anchor你的时间锚点分为四个区块In Progress当前任务同一时间只允许一个Completed (this session)已完成任务 一行验证说明Backlog (next up)接下来要做的Blocked被阻塞的任务及原因它的作用很关键新会话开始时Agent 打开这个文件就知道上次做到哪、接下来干什么而不是让你重新复述一遍需求。4️⃣ verify.md —— 完成定义Definition of Donememory/verify.md 规定了任务什么状态才算做完分五类验收标准文本验证类型检查、Lint、测试全部通过运行验证代码真的跑过不只是写完了视觉验证UI 改动必须截图存证独立验证不允许 Agent 自说自话看起来对任务专属标准针对每个切片的自定义验收项规则很硬没满足 verify.md 的条目progress.md 里就不许打勾。5️⃣ gotchas.md —— 错误教训日志memory/gotchas.md 记录人纠正过的每一个错误格式为- **日期** — *犯了什么错* → **规则**比如假设环境变量存在、静默回退为空字符串这样的坑会被提炼成一条硬规则。新会话开始前必须先复习它目标是把错误率压到零——同一个坑不摔第二次。光写文件还不够钩子强制执行很多记忆系统死在 Agent 偷懒不改文件上。agent-md 的解法是把关键记忆文件升级为可执行契约状态钩子state-enforcement.sh 会在 Agent 想收工时检查——如果源码文件变了但memory/progress.md没更新直接拦截、不许结束完成校验stop-verify.sh 在收尾时跑类型检查、Lint 和测试不通过就拦住行为边界block-destructive.sh 硬性阻断危险命令对应的行为测试可以看 tests/state-enforcement.bats里面明确验证了源码改了但 progress.md 没动 → 拦截这条规则。简单说想忘记系统不让你忘。快速上手三步装好记忆系统git clone https://gitcode.com/gh_mirrors/cla/agent-md cd agent-md ./install.sh --agentclaude /path/to/your-project安装器默认支持 Claude Code、Codex、Cursor 和 Windsurf详见 README.md 和 install.sh。两个值得注意的细节✅已有记忆永不覆盖installer 只补全缺失的memory/*.md你已有的进度、计划原样保留见 install.sh 中的逻辑⚙️可选确定性校验把 agent-md.toml.example 复制为agent-md.toml显式声明 typecheck / lint / test 命令避免钩子靠猜使用建议让记忆系统真正转起来会话开始先读会话结束必写这是 AGENT.md 对 Agent 的硬性要求人也要监督gotchas.md 要当真的记每次纠正 Agent 后花 10 秒补一条是投入产出比最高的动作progress.md 的任务保持原子化一条任务一行太大就拆这是钩子能精准拦截的前提验收标准前置动手前先把这条切片的完成标准写进 verify.md避免做完了但没人认小结agent-md 的 5 文件记忆系统本质上是把人脑里的项目状态外化成五个职责单一的 Markdown 文件再配合钩子强制执行文件一句话职责agents.md环境与工具登记plan.md宏观设计防方向漂移progress.md原子进度跨会话时间锚点verify.md完成定义验收有据gotchas.md错误日志坑不重踩下次再开新会话Agent 打开这五份档案就能无缝接上进度——不忘事、不漂移、少重复犯错靠的不是更大的上下文窗口而是这套朴素但可靠的文件契约。赞分享【免费下载链接】agent-mdProduction-grade agent directives for autonomous coding agents: Claude Code, Codex, Cursor, Windsurf, Aider.项目地址https://gitcode.com/gh_mirrors/cla/agent-md点击查看免费下载相关推荐Loki Mode 记忆系统解析AI Agent 跨会话、跨项目学习的完整指南如何不再重复踩坑Loki Mode 记忆系统解析AI Agent 跨会话、跨项目学习的完整指南如何不再重复踩坑 Loki Mode 是一款自治软件工厂Autonomous5 分钟搞懂 go2rtc把任意摄像头接进浏览器一文讲清5 分钟搞懂 go2rtc把任意摄像头接进浏览器一文讲清 家里 5 个 RTSP 摄像头、2 个门铃阳台还蹲着一台 Wyze各家 App 不通用、协议不音视频视频后端智能硬件Engram 持久记忆协议为 Claude Code 与 Codex 构建跨会话、跨压缩的 AI 编程 Agent 记忆系统Engram 持久记忆协议为 Claude Code 与 Codex 构建跨会话、跨压缩的 AI 编程 Agent 记忆系统 导读 本文讲解 Engram 仓人工智能AI AgentAgent记忆MCP服务上一篇魔兽争霸III优化指南现代系统兼容性解决方案与性能调优策略下一篇IsaacLab执行器配置深度解析从基础模型到高级应用实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考