AGENTS.md配置

项目元数据

• 名称: 企业级用户管理系统
• 技术栈: TypeScript, React, Node.js, MongoDB
• 架构模式: 微服务 + 事件驱动

### 阶段二：能力定义与边界设定

1. **功能矩阵**：明确AI助手应具备的核心能力
```markdown
## AI能力配置
- 代码生成: 启用
- 重构建议: 启用
- 文档生成: 启用
- 安全审计: 启用
- 性能优化: 启用

2. 约束规则：设定开发规范和质量标准

   ## 开发约束
   - 禁止使用任何未经验证的第三方库
   - 所有API必须包含JSDoc注释
   - 组件必须通过单元测试（覆盖率>80%）
   - 状态管理必须使用Redux Toolkit
   

阶段三：场景定制与优化迭代

1. 场景配置：为不同开发阶段创建定制规则

   ## 场景配置
   ### 开发阶段
   - 优先级: 开发速度 > 代码优化
   - 辅助重点: 组件生成、API集成、调试支持
   
   ### 测试阶段
   - 优先级: 测试覆盖率 > 开发速度
   - 辅助重点: 测试用例生成、边界条件检查
   

2. 持续优化：建立配置迭代机制

   • 每两周审查配置效果
   • 根据团队反馈调整规则
   • 跟踪AI辅助效率指标变化

四、场景拓展：AGENTS.md的多样化应用

1. 大型团队协作场景

在百人以上开发团队中，AGENTS.md可作为技术规范的执行载体：

• 新人引导：自动为新成员提供符合项目规范的AI辅助
• 跨团队协作：确保不同子团队使用统一的开发标准
• 技术债务管理：通过AI辅助逐步重构遗留代码

实施案例：某电商平台通过AGENTS.md将代码审查时间减少40%，新功能交付周期缩短25%。

2. 开源项目维护场景

开源项目维护者可通过AGENTS.md：

• 贡献者引导：为外部贡献者提供标准化开发指南
• 自动化文档：保持API文档与代码实现同步更新
• issue处理：快速生成bug复现步骤和修复建议

3. 教学培训场景

教育机构可利用AGENTS.md创建个性化学习环境：

• 阶段性指导：根据学习进度调整AI辅助强度
• 错误解释：针对常见错误提供定制化解释
• 实践项目：快速配置符合教学目标的开发环境

五、高级实践：AGENTS.md最佳策略

1. 配置分层管理模式

实施多级配置架构：

• 基础层：项目通用规范（团队共享）
• 模块层：特定模块的特殊规则
• 个人层：开发者个性化偏好（不影响团队规范）

示例结构：

/AGENTS.md              # 基础配置
/src/auth/AGENTS.md     # 认证模块配置
/src/payment/AGENTS.md  # 支付模块配置