AGENTS.md + Skills + MCP：AI编程的“三层工具箱

旋律~学

280人浏览 · 2026-07-30 16:45:01

旋律~学 · 2026-07-30 16:45:01 发布

AGENTS.md + Skills + MCP：AI编程的“三层工具箱

AGENTS.md是Linux基金会AAIF统一托管标准，已被OpenAI Codex、Claude Code、Cursor、GitHub Copilot、Aider、Google Gemini CLI等主流工具原生支持。其中，Codex和Claude Code是当前AI编程工具中最主流的两个，它们都原生读取AGENTS.md作为项目指令文件。

第一层：AGENTS.md——给AI立规矩，一次说清永不重复

AGENTS.md是一份放在项目根目录的文本文件，AI每次打开项目都会自动读它。README.md是给人看的说明书，AGENTS.md是给AI看的指令卡。

注意：Claude Code原生只认CLAUDE.md，但你可以通过软链接让它读取AGENTS.md：ln -s AGENTS.md CLAUDE.md。OpenAI Codex则原生支持AGENTS.md，在~/.codex/目录和项目根目录都会自动读取。

一份完整的AGENTS.md长什么样？

# AGENTS.md - 项目AI开发规范

## 项目概述
- 项目名称：xxx
- 技术栈：Spring Boot 3.x + MyBatis-Plus + MySQL
- 架构：前后端分离，RESTful API

## 环境搭建
- JDK 17+
- Maven 3.8+
- 数据库：MySQL 8.0
- 启动命令：`mvn spring-boot:run`

## 代码风格规范
- 类名：大驼峰（UserService）
- 方法名：小驼峰（getUserById）
- 常量：全大写下划线（MAX_RETRY_COUNT）
- 所有public方法必须写Javadoc
- 每个类必须有@author和@date

## 包结构规范
- controller：接收请求、参数校验、返回Result<T>
- service：业务逻辑、事务管理
- mapper：数据库操作
- entity：实体类
- dto：数据传输对象
- config：配置类
- common：工具类、常量、异常

## Controller层规范
- 统一返回Result<T>格式
- 使用@Valid校验入参
- URL使用复数名词，如 /api/users
- 所有接口必须有Knife4j/Swagger注解

## Service层规范
- 接口+实现类分离（UserService + UserServiceImpl）
- 事务注解 @Transactional(rollbackFor = Exception.class)
- 方法命名：getXxx、listXxx、saveXxx、updateXxx、deleteXxx

## 数据库规范
- 表名：小写加下划线（user_order）
- 主键：id（BIGINT自增）
- 所有表必须有create_time和update_time
- 时间字段用LocalDateTime
- 不写物理外键，用逻辑关联

## Git提交规范
- feat: 新功能
- fix: 修复bug
- docs: 文档修改
- refactor: 重构
- test: 测试
- chore: 构建/工具变动

## 测试规范
- 单元测试：JUnit 5 + Mockito
- 集成测试：@SpringBootTest
- 测试覆盖率目标：80%

第二层：Skills——把高频任务变成“一键调用”

Skills是提前定义好的工作流模板——把“怎么处理某类任务”写成固定流程，以后遇到同类任务，AI直接按模板走。

最值得装的Skills

星级	Skill	作者	一句话说明	安装方式
⭐⭐⭐⭐⭐	Context7	intellectronica	实时拉取最新API文档，不用手动贴链接	`claude mcp add context7 -- npx -y @upstash/context7-mcp`
⭐⭐⭐⭐⭐	Frontend Design	Anthropic官方	让AI生成的UI不像AI做的	`/plugin install frontend-design@anthropics/claude-code`
⭐⭐⭐⭐⭐	planning-with-files	OthmanAdi	把AI的规划和待办写进本地Markdown，全程可追溯	`/plugin marketplace add OthmanAdi/planning-with-files` + `/plugin install planning-with-files@planning-with-files`
⭐⭐⭐⭐⭐	docx / xlsx / pdf / pptx	Anthropic官方	文档处理四件套，AI直接操作Office文件	`claude skill install docx` 等
⭐⭐⭐⭐	Code Review	Supercent	自动代码审查，检查注释/测试/类型	`npx skills add supercent-io/skills-template@code-review`
⭐⭐⭐⭐	React Best Practices	Vercel Labs	45条React/Next.js性能优化规则	`npx skills add vercel-labs/agent-skills@react-best-practices`
⭐⭐⭐⭐	Web Design Guidelines	Vercel Labs	对照100+最佳实践审查UI	`npx skills add vercel-labs/agent-skills@web-design-guidelines`
⭐⭐⭐⭐	Superpowers	obra	TDD/代码审查/Git工作流套装	`npx skills add obra/superpowers`
⭐⭐⭐	Trail of Bits Security	Trail of Bits	安全审计、供应链风险扫描	`npx skills add trailofbits/agent-skills@security`
⭐⭐⭐	UI-UX-Pro-Max	Next Level Builder	视觉层级+色彩心理学+交互模式	`npx skills add nextlevelbuilder/ui-ux-pro-max-skill@ui-ux-pro-max`

第三层：MCP——给AI接上“手和脚”

MCP（Model Context Protocol）是Anthropic捐赠给Linux基金会AAIF的通用标准协议，让AI能统一调用各种外部工具——读文件、查数据库、检索文档、操作Git，全都可以。

最值得装的MCP服务

星级	MCP服务	功能说明	安装命令
⭐⭐⭐⭐⭐	Context7	实时拉最新文档，避免用废弃API	`claude mcp add --transport stdio context7 -- npx -y @upstash/context7-mcp@latest`
⭐⭐⭐⭐⭐	GitHub官方	读仓库、搜代码、管理Issue/PR	`claude mcp add --transport http github https://mcp.github.com/mcp`
⭐⭐⭐⭐⭐	Filesystem	读写本地文件和目录	`claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem /你的项目路径`
⭐⭐⭐⭐⭐	skill-library-mcp	15,000+ Skills 按需加载，按需安装	`claude mcp add skill-library -- npx -y skill-library-mcp`
⭐⭐⭐⭐	Playwright	浏览器自动化（测试/爬虫）	`claude mcp add --transport stdio playwright -- npx -y @modelcontextprotocol/server-playwright`
⭐⭐⭐⭐	Snyk	代码安全漏洞扫描	`claude mcp add --transport stdio snyk -- npx -y @snyk/mcp-server`
⭐⭐⭐⭐	Supabase	查数据库schema、执行查询	`claude mcp add --transport stdio supabase -- npx -y @supabase/mcp-server`
⭐⭐⭐⭐	skills-master-mcp	8,000+ Skills 搜索、安装、管理	`claude mcp add skills-master -- npx skills-master-mcp`
⭐⭐⭐	腾讯云日志服务CLS	用自然语言查日志	参考腾讯云CLS MCP文档
⭐⭐⭐	TAPD MCP Server	自然语言管理需求/缺陷/任务	参考TAPD MCP文档