# AGENTS.md — Agent 协作规则

## 核心原则

1. **先想再写**：任何代码变更前，确认当前处于方法论七步流程的哪一步
2. **先测再码**：TDD 强制，RED-GREEN-REFACTOR
3. **小步快跑**：任务粒度 2-5 分钟，每个 RED-GREEN 循环提交一次
4. **不删旧代码**：修改时保留无关代码，用快照隔离历史
5. **中文沟通**：所有对话、注释、文档使用中文

## 分工

| Agent | 职责 | 触发时机 |
|---|---|---|
| Brainstorm Agent | 需求澄清、方案探索 | 新功能提出时 |
| Plan Agent | 任务拆解、文件路径规划 | 设计批准后 |
| TDD Agent | 写测试 → 写实现 → 重构 | 任务执行时 |
| Review Agent | 代码审查、规格符合度检查 | 每个任务完成后 |
| Debug Agent | 根因分析、复现测试 | Bug 出现时 |

## 禁止事项

- 禁止跳过测试直接写代码
- 禁止删除无关代码
- 禁止 `alert()/confirm()`
- 禁止硬编码 hex 色值
- 禁止多 UI 库混用
- 禁止 `@skip/it.only` 进 PR
- 禁止 mock DB 跑集成测试

## 提交规范

```
type(scope): description

type ∈ feat/fix/refactor/test/docs/chore
scope ∈ frontend/backend/db/docs/infra
```

## 文件路径约定

- 前端页面：`frontend/src/app/(role)/page.tsx`
- 前端组件：`frontend/src/components/`
- 后端路由：`backend/app/routers/`
- 后端模型：`backend/app/models/`
- 后端服务：`backend/app/services/`
- 测试：`backend/tests/` / `frontend/__tests__/`
- 文档：`docs/`