构建下一代语境感知型 AI Agent：AGENTS.md 与 SKILL.md 发现系统的深度工程架构报告

1. 执行摘要

随着 LLM 从对话界面演进为具备自主行动能力的 Agent，软件开发范式正从指令式编程转向基于意图和语境的编排。Agent 的效能瓶颈已不再是推理能力，而是其获取并遵循项目特定语境的能力。

为了解决“语境孤岛”，行业正向标准化协议收敛：

• AGENTS.md：作为项目的“宪法”，定义架构规范与行为准则（治理）。
• SKILL.md：作为可执行的“技能包”，赋予动态调用的操作能力（能力）。

本报告剖析了如何构建具备自主发现、解析并利用这些文件的 Agent，涵盖从文件系统遍历、AST 解析到基于 MCP 协议的安全沙箱执行环境的完整路线图。

2. 语境危机与 Agent 架构的演进

2.1 从“提示词工程”到“提示词运营（PromptOps）”

早期依赖庞大的系统提示词（System Prompt）存在两大局限：

1. 语境污染：全量语境注入（Context Stuffing）挤压上下文窗口，导致模型注意力下降。
2. 维护困难：硬编码的规则难以随代码库迭代。

**“配置即代码（Configuration as Code）”**的理念应运而生，将行为准则定义为版本受控的文件。

2.2 上下文感知的标准化协议

• AGENTS.md (项目的神经中枢)：解决 Agent “我是谁？我在哪里？遵循什么规则？”的问题。支持层级化继承，允许规则覆盖与合并。
• SKILL.md (模块化的能力单元)：采用渐进式披露模式。只有在识别到意图时才加载相关指令，优化 Token 效率。

3. 行业实现深度剖析

3.1 OpenAI Codex 与 GitHub Copilot：语境分层

• 发现机制：从用户主目录向上扫描至当前工作目录（CWD）。
• 优先级逻辑：距离 CWD 越近的文件优先级越高，实现“局部优于全局”。

3.2 Anthropic (Claude Code)：虚拟机与技能挂载

• VM 架构：在受控虚拟机中运行。
• 子智能体模式：主 Agent 编排，根据 SKILL.md 启动加载特定上下文的子 Agent 以隔离干扰。

3.3 Cursor：语义检索增强 (RAG)

• 精细化控制：引入 .mdc 格式，利用 Glob 模式（如 *.ts）限定规则生效范围。
• 语义路由：对技能描述进行向量索引，动态匹配用户查询。

4. 自研 Agent 核心模块架构

系统架构划分为四个核心层级：

5. 模块实现详解

5.1 发现引擎：智能遍历

实现基于 .gitignore 感知的遍历器。

• 自底向上：寻找 AGENTS.md 以构建规则链。
• 自顶向下：全局索引 SKILL.md 构建技能库。

5.2 认知解析：AST 与元数据

• 语义合并：解析 AGENTS.md 为 AST，基于标题（Header）进行内容覆盖或追加。
• SKILL.md 验证：严格校验 YAML 中的 name、description 和 allowed-tools（安全白名单）。

5.3 语境管理：动态 Prompt 构建

采用三层结构构建系统提示词：

1. 身份层：基本人设。
2. 宪法层：合并后的 AGENTS.md（始终在线）。
3. 能力索引层：仅包含技能名称与描述，具体指令按需加载（Lazy Loading）。

5.4 执行运行时：基于 MCP 的沙箱

为了防御 RCE 风险，必须采用隔离环境：

• MCP 协议：将文件系统和工具调用标准化。
• 沙箱化：使用 Docker 容器或 Firecracker MicroVMs 运行 SKILL.md 中定义的脚本。

6. 战略价值

1. 知识资产化：将团队隐性知识转化为可执行的代码。
2. 跨平台互操作：遵循 AGENTS.md 等标准，避免供应商锁定。
3. 无限扩展性：通过添加技能文件夹即可赋予 Agent 新能力，无需微调模型。

7. 总结与展望

构建此类 Agent 是 AI 辅助开发走向工业级的关键。未来，自我进化型 Agent 将成为主流：它们不仅读取规范，还能通过观察项目偏差，主动发起 PR 更新 AGENTS.md，实现 DevOps 闭环。

附录：核心技术规格对比表