AI 编程 Agent 的协作规约：AGENTS.md、Skills、Hooks、MCP 怎么配合

我最早从 Claude Code 开始认真地用 AI 编程，笔记里写了不少 Claude 专属的内容。现在各家工具的规约文件、技能、事件钩子、外部工具接口基本都通用了，大家似乎都在朝着互通共享的方向走。这篇文章正好把以前写的那些内容配合我现在的与 AI 协作的方式进行整合。

规约的原因

Prompt 本身是软约束，上下文变长的话，规则的优先级会被稀释，AI 会出现幻觉，开始词不达意，忽略强调过的要求。

所以规约要分层：软约束负责日常，强制执行兜底。

第一层：规约文件

每个工具都会在会话开始时自动加载一个说明文件：

AGENTS.md 正在变成事实标准，但是只有 Claude 死活坚守它的 Claude.MD 真是神经病了，当他在使用其他工作区或者其他 AI 想要读取他的内容的时候，如何保证他真的能读取到，以及在上下文中是否浪费了许多 Token，我就很头疼这个问题了。我的做法是 AGENTS.md 自己保存到仓库中，通过软链到各工具入口，不同 AI 对于我的规约都是同步的，只需要根据不同的模型，或者是它们应用的场合，再补充一些说明就行。

规约文件的内容：项目约定、目录结构、命名规范、工作流触发词、禁止事项。内容也不能太多，不然占据大量的上下文，AI 也会产生幻觉。 其次是尝试树形结构，顶层进行通用的基本的框架规约，具体的文件夹有自己的开发方式与附加约束，通过不断的递进和软链连接，AI 就知道它在当前工作区一共要遵守多少层的约束。

第二层： Skills

规约文件常驻，Skills 按需调用。同样一个内容需要反复执行，那就可以做成 Skill ，让它进行复用。

各家形态略有差异，但是现在随着适配度越来越广，就我目前而言，我在根目录存的 Skill 文件夹，Kimi、Deepseek 都可以直接读取到，并正确使用。核心思路都是一样的：把「怎么做」从对话里抽出来，变成可复用、可版本管理的包。

第三层：Hooks（事件级强制）

规则被忽略两次以上，就该转成 Hook：在事件节点挂脚本，用退出码决定放行还是拦截。

基本用法：

• 写文件后自动格式化（PostToolUse）
• 危险命令拦截（PreToolUse，rm -rf 直接拒）
• 长任务结束通知（Stop）

Hook 只做确定性动作，不能滥用。

第四层：MCP（外部工具接入）

MCP 是 Anthropic 提出的开放标准，通过此协议，AI 可以去调用外部的第三方服务，用来完成自己做不到的事情。通过 MCP 把数据库、文件系统、第三方服务接进来，不用为每个工具单独写适配。

例如，文本大模型没办法读取图片内容，但是如果你给它一个识图链接跟说明，它就知道可以将图片发送给对方，等待对方将图片内容返回，自己再整理好文字，就知道图片内容，然后再把结果返回给用户

• stdio：本地子进程，最常用
• HTTP：远程服务
• 配置：.mcp.json，local / project / user 三个作用域

记忆与上下文

规约解决 AI 应该怎么做，记忆解决AI 应该记住什么。

• 变更感知：AI 不知道你上次会话后改了哪些文件。给 AI 一本变更日志，增量读取，——思路见 给 AI 一本变更日志：我写了一个 Obsidian 插件
• 记忆分层：工作记忆 / 情节记忆 / 语义记忆，过去的事情直接存档，不要在上下文中再提及了——见 生产级 Agent 记忆系统架构设计

工作流

规约和能力都齐了，最后是流程：需求 → PRD → 分阶段实现 → 每阶段验收。要点：先规划再动手、分阶段验收、一切落到文档。完整九阶段流程见 AI 驱动项目开发：从零到上线的完整流程。

一张对照表

具体能力以各家文档为准，这是我在用的版本的大概情况。

参考文章

• Claude Code 扩展功能全景： CLAUDE.md / Skills / MCP / Hooks / Subagents
• Agent 防遗忘 Hook 机制
• MCP 协议入门 + 自建 Apple OCR 图片识别工具
• 大模型网页抓取原理