docs:将 AI 代码检查指南翻译为英文

- 将主要内容从中文翻译为英文
- 添加用户信息配置脚本使用说明
- 优化文档结构和可读性
- 保持原有检查流程和规范不变
This commit is contained in:
moyin
2026-01-14 13:17:12 +08:00
parent 43874892b7
commit 8bcd22ea50

View File

@@ -1,361 +1,397 @@
# AI代码检查执行指南 - Whale Town 游戏服务器 # AI Code Inspection Guide - Whale Town Game Server
## 🎯 执行前准备 ## 🎯 Pre-execution Setup
### 📋 必须收集的用户信息 ### 🚀 User Information Setup
在开始任何检查之前,**必须**收集以下信息: **Before starting any inspection steps, run the user information script:**
- **用户当前日期**:用于修改记录和时间戳更新
- **用户名称**:用于@author字段处理和修改记录
### 🏗️ 项目特性识别 ```bash
本项目是**NestJS游戏服务器**,具有以下特点: # Enter AI-reading directory
- **双模式架构**:支持数据库模式和内存模式 cd docs/ai-reading
- **实时通信**基于WebSocket的实时双向通信
- **属性测试**管理员模块使用fast-check进行随机化测试
- **分层架构**Core层技术实现+ Business层业务逻辑
## 🔄 执行原则 # Run user information setup script
node tools/setup-user-info.js
### 🚨 中间步骤开始规范(重要)
**如果AI从任何中间步骤开始执行非步骤1开始必须首先完成以下准备工作**
#### 📋 强制信息收集
在执行任何中间步骤之前AI必须
1. **收集用户当前日期**:用于修改记录和时间戳更新
2. **收集用户名称**:用于@author字段处理和修改记录
3. **确认项目特性**识别这是NestJS游戏服务器项目的特点
#### 🔍 全局上下文获取
AI必须先了解
- **项目架构**:双模式架构(数据库+内存、分层结构Core+Business
- **技术栈**NestJS、WebSocket、Jest测试、fast-check属性测试
- **文件结构**:当前项目的整体文件组织方式
- **已有规范**:项目中已建立的命名、注释、测试等规范
#### 🎯 执行流程约束
```
中间步骤开始请求
🚨 强制收集用户信息(日期、名称)
🚨 强制识别项目特性和上下文
🚨 强制了解目标步骤的具体要求
开始执行指定步骤
``` ```
**⚠️ 违规处理如果AI跳过信息收集直接执行中间步骤用户应要求AI重新开始并完成准备工作。** #### Script Functions
- Automatically get current date (YYYY-MM-DD format)
- Check if config file exists or date matches
- Prompt for username/nickname input if needed
- Save to `me.config.json` file for AI inspection steps
### ⚠️ 强制要求 #### Config File Format
- **分步执行**:每次只执行一个步骤,严禁跳步骤或合并执行 ```json
- **等待确认**:每步完成后必须等待用户确认才能进行下一步 {
- **修改验证**:每次修改文件后必须重新检查该步骤并提供验证报告 "date": "2026-01-13",
- **🔥 修改后必须重新执行当前步骤**如果在当前步骤中发生了任何修改行为文件修改、重命名、移动等AI必须立即重新执行该步骤的完整检查不能直接进入下一步骤 "name": "Developer Name"
- **问题修复后重检**如果当前步骤出现问题需要修改时AI必须在解决问题后重新执行该步骤确保没有其他遗漏的问题 }
- **用户信息使用**:所有日期字段使用用户提供的真实日期,@author字段正确处理
### 🎯 执行流程
```
用户请求代码检查
收集用户信息(日期、名称)
识别项目特性
执行步骤1 → 提供报告 → 等待确认
[如果发生修改] → 🔥 立即重新执行步骤1 → 验证报告 → 等待确认
执行步骤2 → 提供报告 → 等待确认
[如果发生修改] → 🔥 立即重新执行步骤2 → 验证报告 → 等待确认
执行步骤3 → 提供报告 → 等待确认
[如果发生修改] → 🔥 立即重新执行步骤3 → 验证报告 → 等待确认
执行步骤4 → 提供报告 → 等待确认
[如果发生修改] → 🔥 立即重新执行步骤4 → 验证报告 → 等待确认
执行步骤5 → 提供报告 → 等待确认
[如果发生修改] → 🔥 立即重新执行步骤5 → 验证报告 → 等待确认
执行步骤6 → 提供报告 → 等待确认
[如果发生修改] → 🔥 立即重新执行步骤6 → 验证报告 → 等待确认
执行步骤7 → 提供报告 → 等待确认
[如果发生修改] → 🔥 立即重新执行步骤7 → 验证报告 → 等待确认
⚠️ 关键规则:任何步骤中发生修改行为后,必须立即重新执行该步骤!
``` ```
## 📚 步骤执行指导 ### 📋 Using Config in AI Inspection Steps
When AI executes inspection steps, get user info from config file:
### 步骤1命名规范检查 ```javascript
**执行时读取:** `step1-naming-convention.md` // Read config file
**重点关注:** 文件夹结构扁平化、游戏服务器特殊文件类型 const fs = require('fs');
**完成后:** 提供检查报告,等待用户确认 const config = JSON.parse(fs.readFileSync('docs/ai-reading/me.config.json', 'utf-8'));
### 步骤2注释规范检查 // Get user information
**执行时读取:** `step2-comment-standard.md` const userDate = config.date; // e.g.: "2026-01-13"
**重点关注:** @author字段处理、修改记录更新、时间戳规则 const userName = config.name; // e.g.: "John"
**完成后:** 提供检查报告,等待用户确认
### 步骤3代码质量检查 // Use for modification records and @author fields
**执行时读取:** `step3-code-quality.md` const modifyRecord = `- ${userDate}: Code standard optimization - Clean unused imports (Modified by: ${userName})`;
**重点关注:** TODO项处理、未使用代码清理 ```
**完成后:** 提供检查报告,等待用户确认
### 步骤4架构分层检查 ### 🏗️ Project Characteristics
**执行时读取:** `step4-architecture-layer.md` This project is a **NestJS Game Server** with the following features:
**重点关注:** Core层命名规范、依赖关系检查 - **Dual-mode Architecture**: Supports both database and memory modes
**完成后:** 提供检查报告,等待用户确认 - **Real-time Communication**: WebSocket-based real-time bidirectional communication
- **Property Testing**: Admin modules use fast-check for randomized testing
- **Layered Architecture**: Core layer (technical implementation) + Business layer (business logic)
### 步骤5测试覆盖检查 ## 🔄 Execution Principles
**执行时读取:** `step5-test-coverage.md`
**重点关注:** 严格一对一测试映射、测试文件位置、测试执行验证
**完成后:** 提供检查报告,等待用户确认
#### 🧪 测试文件调试规范 ### 🚨 Mid-step Start Requirements (Important)
**调试测试文件时必须遵循以下流程:** **If AI starts execution from any intermediate step (not starting from step 1), must first complete the following preparation:**
1. **读取jest.config.js配置** #### 📋 Mandatory Information Collection
- 查看jest.config.js了解测试环境配置 Before executing any intermediate step, AI must:
- 确认testRegex模式和文件匹配规则 1. **Collect user current date**: For modification records and timestamp updates
- 了解moduleNameMapper和其他配置项 2. **Collect user name**: For @author field handling and modification records
3. **Confirm project characteristics**: Identify NestJS game server project features
2. **使用package.json中的已有测试指令** #### 🔍 Global Context Acquisition
- **禁止自定义jest命令**必须使用package.json中scripts定义的测试命令 AI must first understand:
- **常用测试指令** - **Project Architecture**: Dual-mode architecture (database+memory), layered structure (Core+Business)
- `npm run test` - 运行所有测试 - **Tech Stack**: NestJS, WebSocket, Jest testing, fast-check property testing
- `npm run test:unit` - 运行单元测试(.spec.ts文件) - **File Structure**: Overall file organization of current project
- `npm run test:integration` - 运行集成测试(.integration.spec.ts文件) - **Existing Standards**: Established naming, commenting, testing standards in project
- `npm run test:e2e` - 运行端到端测试(.e2e.spec.ts文件)
- `npm run test:watch` - 监视模式运行测试
- `npm run test:cov` - 运行测试并生成覆盖率报告
- `npm run test:debug` - 调试模式运行测试
- `npm run test:isolated` - 隔离运行测试
3. **特定模块测试指令** #### 🎯 Execution Flow Constraints
- **Zulip模块测试** ```
- `npm run test:zulip` - 运行所有Zulip相关测试 Mid-step Start Request
- `npm run test:zulip:unit` - 运行Zulip单元测试
- `npm run test:zulip:integration` - 运行Zulip集成测试 🚨 Mandatory User Info Collection (date, name)
- `npm run test:zulip:e2e` - 运行Zulip端到端测试
- `npm run test:zulip:performance` - 运行Zulip性能测试 🚨 Mandatory Project Characteristics & Context Identification
🚨 Mandatory Understanding of Target Step Requirements
Start Executing Specified Step
```
4. **测试执行验证流程** **⚠️ Violation Handling: If AI skips information collection and directly executes intermediate steps, user should require AI to restart and complete preparation work.**
### ⚠️ Mandatory Requirements
- **Step-by-step Execution**: Execute one step at a time, strictly no step skipping or merging
- **Wait for Confirmation**: Must wait for user confirmation after each step before proceeding
- **Modification Verification**: Must re-execute current step after any file modification
- **🔥 Must Re-execute Current Step After Modification**: If any modification behavior occurs during current step (file modification, renaming, moving, etc.), AI must immediately re-execute the complete check of that step, cannot directly proceed to next step
- **Re-check After Problem Fix**: If current step has problems requiring modification, AI must re-execute the step after solving problems to ensure no other issues are missed
- **User Info Usage**: All date fields use user-provided real dates, @author fields handled correctly
### 🎯 Execution Flow
```
User Requests Code Inspection
Collect User Info (date, name)
Identify Project Characteristics
Execute Step 1 → Provide Report → Wait for Confirmation
[If Modification Occurs] → 🔥 Immediately Re-execute Step 1 → Verification Report → Wait for Confirmation
Execute Step 2 → Provide Report → Wait for Confirmation
[If Modification Occurs] → 🔥 Immediately Re-execute Step 2 → Verification Report → Wait for Confirmation
Execute Step 3 → Provide Report → Wait for Confirmation
[If Modification Occurs] → 🔥 Immediately Re-execute Step 3 → Verification Report → Wait for Confirmation
Execute Step 4 → Provide Report → Wait for Confirmation
[If Modification Occurs] → 🔥 Immediately Re-execute Step 4 → Verification Report → Wait for Confirmation
Execute Step 5 → Provide Report → Wait for Confirmation
[If Modification Occurs] → 🔥 Immediately Re-execute Step 5 → Verification Report → Wait for Confirmation
Execute Step 6 → Provide Report → Wait for Confirmation
[If Modification Occurs] → 🔥 Immediately Re-execute Step 6 → Verification Report → Wait for Confirmation
Execute Step 7 → Provide Report → Wait for Confirmation
[If Modification Occurs] → 🔥 Immediately Re-execute Step 7 → Verification Report → Wait for Confirmation
⚠️ Key Rule: After any modification behavior in any step, must immediately re-execute that step!
```
## 📚 Step Execution Guide
### Step 1: Naming Convention Check
**Read when executing:** `step1-naming-convention.md`
**Focus on:** Folder structure flattening, game server special file types
**After completion:** Provide inspection report, wait for user confirmation
### Step 2: Comment Standard Check
**Read when executing:** `step2-comment-standard.md`
**Focus on:** @author field handling, modification record updates, timestamp rules
**After completion:** Provide inspection report, wait for user confirmation
### Step 3: Code Quality Check
**Read when executing:** `step3-code-quality.md`
**Focus on:** TODO item handling, unused code cleanup
**After completion:** Provide inspection report, wait for user confirmation
### Step 4: Architecture Layer Check
**Read when executing:** `step4-architecture-layer.md`
**Focus on:** Core layer naming standards, dependency relationship checks
**After completion:** Provide inspection report, wait for user confirmation
### Step 5: Test Coverage Check
**Read when executing:** `step5-test-coverage.md`
**Focus on:** Strict one-to-one test mapping, test file locations, test execution verification
**After completion:** Provide inspection report, wait for user confirmation
#### 🧪 Test File Debugging Standards
**When debugging test files, must follow this workflow:**
1. **Read jest.config.js Configuration**
- Check jest.config.js to understand test environment configuration
- Confirm testRegex patterns and file matching rules
- Understand moduleNameMapper and other configuration items
2. **Use Existing Test Commands in package.json**
- **Forbidden to customize jest commands**: Must use test commands defined in package.json scripts
- **Common Test Commands**:
- `npm run test` - Run all tests
- `npm run test:unit` - Run unit tests (.spec.ts files)
- `npm run test:integration` - Run integration tests (.integration.spec.ts files)
- `npm run test:e2e` - Run end-to-end tests (.e2e.spec.ts files)
- `npm run test:watch` - Run tests in watch mode
- `npm run test:cov` - Run tests and generate coverage report
- `npm run test:debug` - Run tests in debug mode
- `npm run test:isolated` - Run tests in isolation
3. **Specific Module Test Commands**
- **Zulip Module Tests**:
- `npm run test:zulip` - Run all Zulip-related tests
- `npm run test:zulip:unit` - Run Zulip unit tests
- `npm run test:zulip:integration` - Run Zulip integration tests
- `npm run test:zulip:e2e` - Run Zulip end-to-end tests
- `npm run test:zulip:performance` - Run Zulip performance tests
4. **Test Execution Verification Workflow**
``` ```
发现测试问题 → 读取jest.config.js → 选择合适的npm run test:xxx指令 → 执行测试 → 分析结果 → 修复问题 → 重新执行测试 Discover Test Issue → Read jest.config.js → Choose Appropriate npm run test:xxx Command → Execute Test → Analyze Results → Fix Issues → Re-execute Test
``` ```
5. **测试指令选择原则** 5. **Test Command Selection Principles**
- **单个文件测试**:使用`npm run test -- 文件路径` - **Single File Test**: Use `npm run test -- file_path`
- **特定类型测试**使用对应的test:xxx指令 - **Specific Type Test**: Use corresponding test:xxx command
- **调试测试**:优先使用`npm run test:debug` - **Debug Test**: Prioritize `npm run test:debug`
- **CI/CD环境**:使用`npm run test:isolated` - **CI/CD Environment**: Use `npm run test:isolated`
### 步骤6功能文档生成 ### Step 6: Function Documentation Generation
**执行时读取:** `step6-documentation.md` **Read when executing:** `step6-documentation.md`
**重点关注:** API接口文档、WebSocket事件文档 **Focus on:** API interface documentation, WebSocket event documentation
**完成后:** 提供检查报告,等待用户确认 **After completion:** Provide inspection report, wait for user confirmation
### 步骤7代码提交 ### Step 7: Code Commit
**执行时读取:** `step7-code-commit.md` **Read when executing:** `step7-code-commit.md`
**重点关注:** Git变更校验、修改记录一致性检查、规范化提交流程 **Focus on:** Git change verification, modification record consistency check, standardized commit process
**完成后:** 提供检查报告,等待用户确认 **After completion:** Provide inspection report, wait for user confirmation
## 📋 统一报告模板 ## 📋 Unified Report Template
每步完成后使用此模板报告: Use this template for reporting after each step completion:
``` ```
## 步骤X[步骤名称]检查报告 ## Step X: [Step Name] Inspection Report
### 🔍 检查结果 ### 🔍 Inspection Results
[发现的问题列表] [List of discovered issues]
### 🛠️ 修正方案 ### 🛠️ Correction Plan
[具体修正建议] [Specific correction suggestions]
### ✅ 完成状态 ### ✅ Completion Status
- 检查项1 ✓/✗ - Check Item 1 ✓/✗
- 检查项2 ✓/✗ - Check Item 2 ✓/✗
**请确认修正方案,确认后进行下一步骤** **Please confirm correction plan, proceed to next step after confirmation**
``` ```
## 🚨 全局约束 ## 🚨 Global Constraints
### 📝 文件修改记录规范(重要) ### 📝 File Modification Record Standards (Important)
**每次执行完修改后,文件顶部都需要更新修改记录和相关信息** **After each modification execution, file headers need to update modification records and related information**
#### 修改类型定义 #### Modification Type Definitions
- `代码规范优化` - 命名规范、注释规范、代码清理等 - `Code Standard Optimization` - Naming standards, comment standards, code cleanup, etc.
- `功能新增` - 添加新的功能或方法 - `Feature Addition` - Adding new features or methods
- `功能修改` - 修改现有功能的实现 - `Feature Modification` - Modifying existing feature implementations
- `Bug修复` - 修复代码缺陷 - `Bug Fix` - Fixing code defects
- `性能优化` - 提升代码性能 - `Performance Optimization` - Improving code performance
- `重构` - 代码结构调整但功能不变 - `Refactoring` - Code structure adjustment but functionality unchanged
#### 修改记录格式要求 #### Modification Record Format Requirements
```typescript ```typescript
/** /**
* 最近修改: * Recent Modifications:
* - [用户日期]: 代码规范优化 - 清理未使用的导入 (修改者: [用户名称]) * - [User Date]: Code Standard Optimization - Clean unused imports (Modified by: [User Name])
* - 2024-01-06: Bug修复 - 修复邮箱验证逻辑错误 (修改者: 李四) * - 2024-01-06: Bug Fix - Fix email validation logic error (Modified by: Li Si)
* - 2024-01-05: 功能新增 - 添加用户验证码登录功能 (修改者: 王五) * - 2024-01-05: Feature Addition - Add user verification code login feature (Modified by: Wang Wu)
* *
* @author [处理后的作者名称] * @author [Processed Author Name]
* @version x.x.x * @version x.x.x
* @since [创建日期] * @since [Creation Date]
* @lastModified [用户日期] * @lastModified [User Date]
*/ */
``` ```
#### 🔢 最近修改记录数量限制 #### 🔢 Recent Modification Record Quantity Limit
- **最多保留5条**最近修改记录最多只保留最新的5条记录 - **Maximum 5 Records**: Recent modification records keep maximum of 5 latest records
- **超出自动删除**当添加新的修改记录时如果超过5条自动删除最旧的记录 - **Auto-delete When Exceeded**: When adding new modification records, if exceeding 5, automatically delete oldest records
- **保持时间顺序**:记录按时间倒序排列,最新的在最上面 - **Maintain Time Order**: Records arranged in reverse chronological order, newest at top
- **完整记录保留**:每条记录必须包含完整的日期、修改类型、描述和修改者信息 - **Complete Record Retention**: Each record must include complete date, modification type, description and modifier information
#### 版本号递增规则 #### Version Number Increment Rules
- **修订版本+1**代码规范优化、Bug修复 (1.0.0 → 1.0.1) - **Patch Version +1**: Code standard optimization, bug fixes (1.0.0 → 1.0.1)
- **次版本+1**:功能新增、功能修改 (1.0.1 → 1.1.0) - **Minor Version +1**: Feature addition, feature modification (1.0.1 → 1.1.0)
- **主版本+1**:重构、架构变更 (1.1.0 → 2.0.0) - **Major Version +1**: Refactoring, architecture changes (1.1.0 → 2.0.0)
#### 时间更新规则 #### Time Update Rules
- **仅检查不修改**:如果只是检查而没有实际修改文件内容,**不更新**@lastModified字段 - **Check Only No Modification**: If only checking without actually modifying file content, **do not update** @lastModified field
- **实际修改才更新**:只有真正修改了文件内容时才更新@lastModified字段和添加修改记录 - **Update Only on Actual Modification**: Only update @lastModified field and add modification records when actually modifying file content
- **Git变更检测**:通过`git status``git diff`检查文件是否有实际变更只有git显示文件被修改时才需要添加修改记录和更新时间戳 - **Git Change Detection**: Check if files have actual changes through `git status` and `git diff`, only add modification records and update timestamps when git shows files are modified
#### 🚨 重要强调:纯检查步骤不更新修改记录 #### 🚨 Important Emphasis: Pure Check Steps Do Not Update Modification Records
**AI在执行代码检查步骤时如果发现代码已经符合规范无需任何修改** **When AI executes code inspection steps, if code already meets standards and needs no modification, then:**
- **禁止添加修改记录**:不要添加类似"AI代码检查步骤XXXX检查和优化"的记录 - **Forbidden to Add Modification Records**: Do not add records like "AI code inspection step X: XXX check and optimization"
- **禁止更新时间戳**:不要更新@lastModified字段 - **Forbidden to Update Timestamps**: Do not update @lastModified field
- **禁止递增版本号**:不要修改@version字段 - **Forbidden to Increment Version Numbers**: Do not modify @version field
- **只有实际修改了代码内容、注释内容、结构等才需要更新修改记录** - **Only add modification records when actually modifying code content, comment content, structure, etc.**
**错误示例** **Wrong Example**:
```typescript ```typescript
// ❌ 错误:仅检查无修改却添加了修改记录 // ❌ Wrong: Only checked without modification but added modification record
/** /**
* 最近修改: * Recent Modifications:
* - 2026-01-12: 代码规范优化 - AI代码检查步骤2注释规范检查和优化 (修改者: moyin) // 这是错误的! * - 2026-01-12: Code Standard Optimization - AI code inspection step 2: Comment standard check and optimization (Modified by: moyin) // This is wrong!
* - 2026-01-07: 功能新增 - 添加用户验证功能 (修改者: 张三) * - 2026-01-07: Feature Addition - Add user verification feature (Modified by: Zhang San)
*/ */
``` ```
**正确示例** **Correct Example**:
```typescript ```typescript
// ✅ 正确:检查发现符合规范,不添加修改记录 // ✅ Correct: Check found compliance with standards, do not add modification records
/** /**
* 最近修改: * Recent Modifications:
* - 2026-01-07: 功能新增 - 添加用户验证功能 (修改者: 张三) // 保持原有记录不变 * - 2026-01-07: Feature Addition - Add user verification feature (Modified by: Zhang San) // Keep original records unchanged
*/ */
``` ```
### @author字段处理规范 ### @author Field Handling Standards
- **保留原则**:人名必须保留,不得随意修改 - **Retention Principle**: Human names must be retained, cannot be arbitrarily modified
- **AI标识替换**只有AI标识kiroChatGPTClaude、AI等才可替换为用户名称 - **AI Identifier Replacement**: Only AI identifiers (kiro, ChatGPT, Claude, AI, etc.) can be replaced with user names
- **判断示例**`@author kiro` → 可替换,`@author 张三` → 必须保留 - **Judgment Example**: `@author kiro` → Can replace, `@author Zhang San` → Must retain
### 游戏服务器特殊要求 ### Game Server Special Requirements
- **WebSocket文件**Gateway文件必须有完整的连接、消息处理测试 - **WebSocket Files**: Gateway files must have complete connection and message processing tests
- **双模式服务**:内存服务和数据库服务都需要完整测试覆盖 - **Dual-mode Services**: Both memory services and database services need complete test coverage
- **属性测试**管理员模块使用fast-check进行属性测试 - **Property Testing**: Admin modules use fast-check for property testing
- **测试分离**严格区分单元测试、集成测试、E2E测试、性能测试 - **Test Separation**: Strictly distinguish unit tests, integration tests, E2E tests, performance tests
## 🔧 修改验证流程 ## 🔧 Modification Verification Process
### 🔥 修改后立即重新执行规则(重要) ### 🔥 Immediately Re-execute Rule After Modification (Important)
**任何步骤中发生修改行为后AI必须立即重新执行该步骤不能直接进入下一步骤** **After any modification behavior occurs in any step, AI must immediately re-execute that step, cannot directly proceed to next step!**
#### 修改行为包括但不限于: #### Modification Behaviors Include But Not Limited To:
- 文件内容修改(代码、注释、配置等) - File content modification (code, comments, configuration, etc.)
- 文件重命名 - File renaming
- 文件移动 - File moving
- 文件删除 - File deletion
- 新建文件 - New file creation
- 文件夹结构调整 - Folder structure adjustment
#### 强制执行流程: #### Mandatory Execution Process:
``` ```
步骤执行中 → 发现问题 → 执行修改 → 🔥 立即重新执行该步骤 → 验证无遗漏 → 用户确认 → 下一步骤 Step Execution → Discover Issues → Execute Modifications → 🔥 Immediately Re-execute That Step → Verify No Omissions → User Confirmation → Next Step
``` ```
### 问题修复后的重检流程 ### Re-check Process After Problem Fix
当在任何步骤中发现问题并进行修改后,必须遵循以下流程: When issues are discovered and modifications made in any step, must follow this process:
1. **执行修改操作** 1. **Execute Modification Operations**
- 根据发现的问题进行具体修改 - Make specific modifications based on discovered issues
- 确保修改内容准确无误 - Ensure modification content is accurate
- **更新文件顶部的修改记录、版本号和@lastModified字段** - **Update file header modification records, version numbers and @lastModified fields**
2. **🔥 立即重新执行当前步骤** 2. **🔥 Immediately Re-execute Current Step**
- **不能跳过这一步!** - **Cannot skip this step!**
- 完整重新执行该步骤的所有检查项 - Complete re-execution of all check items for that step
- 不能只检查修改的部分,必须全面重检 - Cannot only check modified parts, must comprehensively re-check
3. **提供验证报告** 3. **Provide Verification Report**
- 确认之前发现的问题已解决 - Confirm previously discovered issues are resolved
- 确认没有引入新的问题 - Confirm no new issues introduced
- 确认没有遗漏其他问题 - Confirm no other issues omitted
4. **等待用户确认** 4. **Wait for User Confirmation**
- 提供完整的验证报告 - Provide complete verification report
- 等待用户确认后才能进行下一步骤 - Wait for user confirmation before proceeding to next step
### 验证报告模板 ### Verification Report Template
``` ```
## 步骤X修改验证报告 ## Step X: Modification Verification Report
### 🔧 已执行的修改操作 ### 🔧 Executed Modification Operations
- 修改类型:[文件修改/重命名/移动/删除等] - Modification Type: [File modification/renaming/moving/deletion, etc.]
- 修改内容:[具体修改描述] - Modification Content: [Specific modification description]
- 影响文件:[受影响的文件列表] - Affected Files: [List of affected files]
### 📝 已更新的修改记录 ### 📝 Updated Modification Records
- 添加修改记录:[用户日期]: [修改类型] - [修改内容] (修改者: [用户名称]) - Added Modification Record: [User Date]: [Modification Type] - [Modification Content] (Modified by: [User Name])
- 更新版本号:[旧版本] → [新版本] - Updated Version Number: [Old Version] → [New Version]
- 更新时间戳:@lastModified [用户日期] - Updated Timestamp: @lastModified [User Date]
### 🔍 重新执行步骤X的完整检查结果 ### 🔍 Re-executed Step X Complete Check Results
[完整重新执行该步骤的所有检查项的结果] [Complete re-execution results of all check items for that step]
### ✅ 验证状态 ### ✅ Verification Status
- 原问题已解决 - Original Issues Resolved
- 修改记录已更新 - Modification Records Updated
- 无新问题引入 - No New Issues Introduced
- 无其他遗漏问题 - No Other Issues Omitted
- 步骤X检查完全通过 - Step X Check Completely Passed
**🔥 重要:本步骤已完成修改并重新验证,请确认后进行下一步骤** **🔥 Important: This step has completed modification and re-verification, please confirm before proceeding to next step**
``` ```
### 重检的重要性 ### Importance of Re-checking
- **确保完整性**:避免修改过程中遗漏其他问题 - **Ensure Completeness**: Avoid omitting other issues during modification process
- **防止新问题**:确保修改没有引入新的问题 - **Prevent New Issues**: Ensure modifications do not introduce new problems
- **保证质量**:每个步骤都达到完整的检查标准 - **Maintain Quality**: Each step reaches complete inspection standards
- **维护一致性**:确保整个检查过程的严谨性 - **Maintain Consistency**: Ensure rigor throughout entire inspection process
- **🔥 强制执行**:修改后必须重新执行,不能跳过这个环节 - **🔥 Mandatory Execution**: Cannot skip this step after modifications
## ⚡ 关键成功要素 ## ⚡ Key Success Factors
- **严格按步骤执行**:不跳步骤,不合并执行 - **Strict Step-by-step Execution**: No step skipping, no merged execution
- **🔥 修改后立即重新执行**:任何修改行为后必须立即重新执行当前步骤,不能直接进入下一步 - **🔥 Immediately Re-execute After Modification**: Must immediately re-execute current step after any modification behavior, cannot directly proceed to next step
- **问题修复后必须重检**:修改文件后必须重新执行整个步骤,确保无遗漏 - **Must Re-check After Problem Fix**: Must re-execute entire step after file modification to ensure no omissions
- **修改记录必须更新**:每次修改文件后都必须更新文件顶部的修改记录、版本号和时间戳 - **Must Update Modification Records**: Must update file header modification records, version numbers and timestamps after each file modification
- **真实修改验证**:通过工具验证修改效果 - **Real Modification Verification**: Verify modification effects through tools
- **用户信息准确使用**:日期和名称信息正确应用 - **Accurate User Info Usage**: Correctly apply date and name information
- **项目特性适配**:针对游戏服务器特点优化检查 - **Project Characteristic Adaptation**: Optimize inspections for game server characteristics
- **完整报告提供**:每步都提供详细的检查报告 - **Complete Report Provision**: Provide detailed inspection reports for each step
--- ---
**开始执行前,请确认已收集用户日期和名称信息!** **Before starting execution, please first run `node tools/setup-user-info.js` to set user information!**