AGENTS.md配置文件

技术栈约束

• 主框架：React 18+
• 语言：TypeScript 5.0+
• 状态管理：Redux Toolkit

代码规范

• 命名：PascalCase（组件），camelCase（函数）
• 缩进：2空格
• 注释：JSDoc标准格式

### 阶段二：定义能力边界与约束
1. **核心能力配置**  
明确AI可执行的任务类型：
- ✅ 代码补全与生成
- ✅ 单元测试编写
- ✅ 文档生成
- ❌ 敏感数据处理
- ❌ 外部API调用

2. **避坑指南**
- 避免过度限制导致AI能力削弱
- 关键约束需使用明确的禁止性语言
- 定期审查约束列表，移除过时限制

### 阶段三：定制项目专属规则
1. **架构规范定义**
```markdown
## 项目架构
- 目录结构：
  /components - UI组件
  /hooks - 自定义钩子
  /services - API服务
  /utils - 工具函数
- 数据流：UI → Redux → API → 数据库

2. 进阶版配置示例

   ## 智能场景适配
   ### 开发模式
   - 优先级：功能实现 > 代码优化
   - 允许：使用console.log调试
   ### 生产模式
   - 优先级：性能 > 可读性
   - 要求：必须包含错误处理
   

阶段四：验证与迭代优化

1. 配置验证三步骤

   • 生成测试文件验证规范遵循度
   • 对比配置前后的代码质量变化
   • 收集团队反馈并调整参数

2. 持续优化机制

   • 每季度进行配置审计
   • 结合项目迭代更新技术栈约束
   • 建立配置版本控制

【场景落地】三大实战场景：从个人项目到企业级应用

场景一：个人项目效率提升

实施案例：前端开发者李明在React项目中配置AGENTS.md后，AI助手生成的组件代码符合其个人编码风格，减少80%的格式调整时间。关键配置：

## 个人偏好
- 组件风格：函数式组件+hooks
- 样式方案：Tailwind CSS
- 状态管理：React Context API

场景二：开源项目贡献引导

实施案例：某开源框架通过AGENTS.md将贡献指南编码化，新贡献者提交的PR符合项目规范的比例从45%提升至89%。核心配置：

## 贡献规范
- PR模板：必须包含变更说明、测试用例
- 代码审查：需通过ESLint和单元测试
- 文档要求：API变更必须更新README

场景三：企业级团队协作

实施案例：某金融科技公司通过AGENTS.md实现跨团队AI配置统一，新员工上手速度提升60%，代码缺陷率降低35%。特色配置：

## 企业安全规范
- 禁止：硬编码敏感信息
- 必须：所有API调用包含异常处理
- 加密：用户数据传输需使用公司加密库

【进阶优化】突破常规应用：AGENTS.md创新实践

创新场景一：AI能力分级授权

根据开发人员角色定制AI能力权限：

## 角色权限配置
### 初级开发者
- 能力：基础代码生成、格式修正
- 限制：禁止架构设计建议
### 高级开发者
- 能力：全功能访问
- 额外：架构优化建议、性能瓶颈分析

创新场景二：项目生命周期适配

为不同开发阶段动态调整AI行为：

## 生命周期配置
### 需求阶段
- AI模式：创意激发，提供多种实现思路
- 输出：技术方案对比、可行性分析
### 维护阶段
- AI模式：保守优化，最小化变更影响
- 输出：重构建议、性能优化点

创新场景三：多模态知识集成

将文档与代码知识融合：

## 知识集成
- 设计系统：链接至Figma组件库文档
- API文档：自动引用Swagger规范
- 业务规则：导入公司内部知识库