如何快速上手agent-rules：AI助手规则配置入门教程

想要让你的AI编程助手更聪明、更高效吗？agent-rules项目正是为此而生！这个开源项目汇集了大量可重用的规则和知识文档，专门为Claude Code和Cursor等AI编程助手设计，让你的开发工作如虎添翼。🎯

什么是agent-rules？

agent-rules是一个规则和知识库集合，旨在优化你与AI编程助手的协作体验。无论你是使用Cursor还是Claude Code，这个项目都能帮助你配置智能规则，让AI助手更好地理解你的项目需求和工作流程。

快速开始指南 🚀

第一步：获取项目代码

首先克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/ag/agent-rules
cd agent-rules

第二步：了解项目结构

项目主要包含三个核心目录：

📁 project-rules/ - 开发工作流规则

• commit.mdc - 标准化提交工作流
• check.mdc - 代码质量检查
• bug-fix.mdc - 完整错误修复流程
• pr-review.mdc - 代码审查清单

📁 docs/ - 参考文档和知识库

• Swift开发相关文档
• MCP开发最佳实践

📁 global-rules/ - 全局配置和自动化脚本

针对不同工具的配置方法

为Cursor用户配置

Cursor原生支持.mdc格式文件，配置非常简单：

1. 复制任意.mdc文件到项目的.cursor/rules/目录
2. Cursor会自动基于前置元数据中的glob模式应用规则
3. 设置alwaysApply: true的规则会对所有文件生效

为Claude Code用户配置

1. 将.mdc文件内容（不包括前置元数据）复制到你的CLAUDE.md文件中
2. 或者使用@import语法在你的CLAUDE.md中引用整个文件
3. 可以放在项目根目录或~/.claude/CLAUDE.md中作为全局规则

核心功能亮点 ✨

智能提交工作流

commit.mdc规则提供了完整的提交流程：

• 自动运行预提交检查（lint、构建、生成文档）
• 使用约定式提交格式和描述性表情符号
• 智能建议对不同关注点进行提交拆分

代码质量保障

check.mdc规则执行全面的代码质量检查：

• 代码风格和语法错误检查
• 类型检查和单元测试验证
• 安全扫描和构建验证

实用配置技巧

全局规则设置

将global-rules目录下的规则添加到~/.claude/CLAUDE.md中，可以增强Claude Code在所有项目中的能力。

自动化脚本集成

项目还提供了实用的自动化脚本，如终端标题管理、MCP服务器同步等，让你的开发环境更加智能化。

为什么选择agent-rules？🤔

• 统一格式：.mdc格式同时兼容Cursor和Claude Code
• 即插即用：复制文件即可使用，无需复杂配置
• 社区驱动：汇集了众多开发者的实践经验
• 持续更新：随着AI助手的发展不断优化规则

开始你的AI助手优化之旅

现在就开始使用agent-rules吧！选择适合你工作流的规则文件，复制到对应的配置目录中，立即体验更智能、更高效的AI编程助手协作。

记住，好的工具配置能让你的生产力翻倍，而agent-rules正是你通往高效开发的最佳伙伴！💪