style: 完善代码规范和测试覆盖
- 新增多个模块的单元测试文件,提升测试覆盖率 - 完善AI-Reading文档系统,包含7步代码检查流程 - 新增集成测试和属性测试框架 - 优化项目结构和配置文件 - 清理过时的规范文档,统一使用新的检查标准
This commit is contained in:
@@ -16,6 +16,37 @@
|
||||
|
||||
## 🔄 执行原则
|
||||
|
||||
### 🚨 中间步骤开始规范(重要)
|
||||
**如果AI从任何中间步骤开始执行(非步骤1开始),必须首先完成以下准备工作:**
|
||||
|
||||
#### 📋 强制信息收集
|
||||
在执行任何中间步骤之前,AI必须:
|
||||
1. **收集用户当前日期**:用于修改记录和时间戳更新
|
||||
2. **收集用户名称**:用于@author字段处理和修改记录
|
||||
3. **确认项目特性**:识别这是NestJS游戏服务器项目的特点
|
||||
|
||||
#### 🔍 全局上下文获取
|
||||
AI必须先了解:
|
||||
- **项目架构**:双模式架构(数据库+内存)、分层结构(Core+Business)
|
||||
- **技术栈**:NestJS、WebSocket、Jest测试、fast-check属性测试
|
||||
- **文件结构**:当前项目的整体文件组织方式
|
||||
- **已有规范**:项目中已建立的命名、注释、测试等规范
|
||||
|
||||
#### 🎯 执行流程约束
|
||||
```
|
||||
中间步骤开始请求
|
||||
↓
|
||||
🚨 强制收集用户信息(日期、名称)
|
||||
↓
|
||||
🚨 强制识别项目特性和上下文
|
||||
↓
|
||||
🚨 强制了解目标步骤的具体要求
|
||||
↓
|
||||
开始执行指定步骤
|
||||
```
|
||||
|
||||
**⚠️ 违规处理:如果AI跳过信息收集直接执行中间步骤,用户应要求AI重新开始并完成准备工作。**
|
||||
|
||||
### ⚠️ 强制要求
|
||||
- **分步执行**:每次只执行一个步骤,严禁跳步骤或合并执行
|
||||
- **等待确认**:每步完成后必须等待用户确认才能进行下一步
|
||||
@@ -203,6 +234,32 @@
|
||||
- **实际修改才更新**:只有真正修改了文件内容时才更新@lastModified字段和添加修改记录
|
||||
- **Git变更检测**:通过`git status`和`git diff`检查文件是否有实际变更,只有git显示文件被修改时才需要添加修改记录和更新时间戳
|
||||
|
||||
#### 🚨 重要强调:纯检查步骤不更新修改记录
|
||||
**AI在执行代码检查步骤时,如果发现代码已经符合规范,无需任何修改,则:**
|
||||
- **禁止添加修改记录**:不要添加类似"AI代码检查步骤X:XXX检查和优化"的记录
|
||||
- **禁止更新时间戳**:不要更新@lastModified字段
|
||||
- **禁止递增版本号**:不要修改@version字段
|
||||
- **只有实际修改了代码内容、注释内容、结构等才需要更新修改记录**
|
||||
|
||||
**错误示例**:
|
||||
```typescript
|
||||
// ❌ 错误:仅检查无修改却添加了修改记录
|
||||
/**
|
||||
* 最近修改:
|
||||
* - 2026-01-12: 代码规范优化 - AI代码检查步骤2:注释规范检查和优化 (修改者: moyin) // 这是错误的!
|
||||
* - 2026-01-07: 功能新增 - 添加用户验证功能 (修改者: 张三)
|
||||
*/
|
||||
```
|
||||
|
||||
**正确示例**:
|
||||
```typescript
|
||||
// ✅ 正确:检查发现符合规范,不添加修改记录
|
||||
/**
|
||||
* 最近修改:
|
||||
* - 2026-01-07: 功能新增 - 添加用户验证功能 (修改者: 张三) // 保持原有记录不变
|
||||
*/
|
||||
```
|
||||
|
||||
### @author字段处理规范
|
||||
- **保留原则**:人名必须保留,不得随意修改
|
||||
- **AI标识替换**:只有AI标识(kiro、ChatGPT、Claude、AI等)才可替换为用户名称
|
||||
|
||||
Reference in New Issue
Block a user