# AGENTS.md

## 项目名称
使用大模型辅助开发俄罗斯方块程序

## 基本开发要求

### 编程语言
- 使用 C++。
- 仅使用课程已学基础语法：数组、循环、分支、函数、结构体等。
- 不使用 `class`、继承、多态等面向对象特性。

## 项目结构

- 源码主要位于 `src` 目录。
- 不要随意改动已有全局变量、函数声明和文件结构。
- 如需新增创新功能，可以新增 `.cpp` 文件。

## 构建方式

优先使用项目根目录下的构建脚本：

```powershell
.\build-mingw.ps1
```

## 代码质量要求

1. 每次只实现一个明确功能。
2. 每个函数必须有功能描述注释。
3. 变量命名保持和原框架一致。
4. 不随意改动已有全局变量和函数声明。
5. 生成代码后必须人工审查。
6. 每个阶段完成后必须编译运行。
7. 出现 bug 时，应记录问题、原因和修复过程。

## 开发注意事项

1. 每次补全前后都要保存版本，便于报告展示。
2. 现场汇报时，所有组员都可能被提问，不能只有一人理解代码。