AGENTS.md Configuration

技术栈规范

• 主框架: React 18+
• 语言: TypeScript 5.0+
• 状态管理: Redux Toolkit
• 代码风格: Airbnb JavaScript Style Guide

架构约束

• 组件设计: 函数式组件优先
• 状态管理: 全局状态使用Redux，局部状态使用React useState
• API交互: 统一通过api/目录下的服务函数

安全规范

• 禁止直接使用localStorage存储敏感信息
• API请求必须包含CSRF令牌
• 用户输入必须通过validateInput函数验证

### 行业应用对比：主流AI助手配置方案分析

| 配置方案 | 跨工具支持 | 团队协作 | 配置复杂度 | 学习曲线 |
|---------|----------|---------|----------|---------|
| AGENTS.md | ★★★★★ | ★★★★☆ | ★★☆☆☆ | ★★☆☆☆ |
| VS Code设置 | ★★☆☆☆ | ★★☆☆☆ | ★★★☆☆ | ★★★☆☆ |
| 工具特定配置 | ★☆☆☆☆ | ★☆☆☆☆ | ★★★★☆ | ★★★★☆ |

### 问题诊断流程图

配置不生效? ├─ 检查文件位置 → 必须位于项目根目录 ├─ 验证格式 → 使用ag-validate工具检查语法 ├─ 工具兼容性 → 确认IDE已安装AGENTS.md插件 └─ 缓存问题 → 重启IDE并清除AI模型缓存

## 进阶：释放AGENTS.md的全部潜力

### 多场景智能切换配置
为不同开发阶段创建配置文件变体：
- AGENTS.dev.md (开发环境): 侧重代码生成和快速迭代
- AGENTS.test.md (测试环境): 强化测试用例生成和错误检测
- AGENTS.prod.md (生产环境): 优化性能建议和安全检查

### 团队知识库集成方案
通过以下配置将AGENTS.md与团队文档系统关联：

```markdown
## 知识资源
- 架构决策记录: ./docs/adr/
- API文档: ./docs/api/
- 最佳实践: ./docs/best-practices/
- 常见问题: ./docs/faq.md