style: 完善代码规范和测试覆盖

- 新增多个模块的单元测试文件,提升测试覆盖率
- 完善AI-Reading文档系统,包含7步代码检查流程
- 新增集成测试和属性测试框架
- 优化项目结构和配置文件
- 清理过时的规范文档,统一使用新的检查标准
This commit is contained in:
moyin
2026-01-12 20:09:03 +08:00
parent 59128ea9a6
commit 5af44f95d5
22 changed files with 2595 additions and 2096 deletions

View File

@@ -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代码检查步骤XXXX检查和优化"的记录
- **禁止更新时间戳**:不要更新@lastModified字段
- **禁止递增版本号**:不要修改@version字段
- **只有实际修改了代码内容、注释内容、结构等才需要更新修改记录**
**错误示例**
```typescript
// ❌ 错误:仅检查无修改却添加了修改记录
/**
* 最近修改:
* - 2026-01-12: 代码规范优化 - AI代码检查步骤2注释规范检查和优化 (修改者: moyin) // 这是错误的!
* - 2026-01-07: 功能新增 - 添加用户验证功能 (修改者: 张三)
*/
```
**正确示例**
```typescript
// ✅ 正确:检查发现符合规范,不添加修改记录
/**
* 最近修改:
* - 2026-01-07: 功能新增 - 添加用户验证功能 (修改者: 张三) // 保持原有记录不变
*/
```
### @author字段处理规范
- **保留原则**:人名必须保留,不得随意修改
- **AI标识替换**只有AI标识kiro、ChatGPT、Claude、AI等才可替换为用户名称