gitlab-ai-review 4.2.3 → 6.3.9

package/lib/config.js

@@ -9,7 +9,161 @@ import { analyzeProject } from './project-analyzer.js';
 import { buildGenerateGuardPromptMessages } from './prompt-tools.js';
 
 /**
- * 使用 AI 生成审核提示词
+ * 🔧 从 AI 返回内容中提取增强后的 reviewguard.md 内容
+ * 查找 ===ENHANCED_CONTENT_START=== 和 ===ENHANCED_CONTENT_END=== 之间的内容
+ * @param {string} content - AI 返回的原始内容
+ * @returns {string|null} 提取的增强内容，如果没找到则返回 null
+ */
+function extractEnhancedContent(content) {
+  if (!content || typeof content !== 'string') {
+    return null;
+  }
+
+  // 查找特殊标记
+  const startMarker = '===ENHANCED_CONTENT_START===';
+  const endMarker = '===ENHANCED_CONTENT_END===';
+  
+  const startIdx = content.indexOf(startMarker);
+  const endIdx = content.indexOf(endMarker);
+  
+  if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+    const enhancedContent = content.substring(startIdx + startMarker.length, endIdx).trim();
+    if (enhancedContent.length > 0) {
+      return enhancedContent;
+    }
+  }
+
+  // 备用方案：查找 ```markdown ... ``` 块（可能是完整的增强文档）
+  const markdownBlockMatch = content.match(/```markdown\s*([\s\S]*?)\s*```/);
+  if (markdownBlockMatch && markdownBlockMatch[1].includes('# ')) {
+    const possibleContent = markdownBlockMatch[1].trim();
+    // 检查是否看起来像完整的 reviewguard.md（包含标题和多个章节）
+    if (possibleContent.length > 500 && (possibleContent.match(/^##/gm) || []).length >= 3) {
+      return possibleContent;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * 🔧 解析 AI 返回的 JSON 响应（健壮版本）
+ * 处理各种格式问题：markdown 代码块、转义字符、不完整的 JSON 等
+ * @param {string} content - AI 返回的原始内容
+ * @returns {Object} 解析后的 JSON 对象
+ */
+function parseAIJsonResponse(content) {
+  if (!content || typeof content !== 'string') {
+    throw new Error('无效的输入内容');
+  }
+
+  let jsonStr = content.trim();
+
+  // 策略 1: 提取 ```json ... ``` 代码块
+  const jsonBlockMatch = jsonStr.match(/```json\s*([\s\S]*?)\s*```/);
+  if (jsonBlockMatch) {
+    jsonStr = jsonBlockMatch[1].trim();
+  }
+
+  // 策略 2: 如果还有其他代码块标记，移除它们
+  if (jsonStr.startsWith('```') && jsonStr.endsWith('```')) {
+    jsonStr = jsonStr.slice(3, -3).trim();
+    // 移除可能的语言标识
+    if (jsonStr.startsWith('json')) {
+      jsonStr = jsonStr.slice(4).trim();
+    }
+  }
+
+  // 策略 3: 尝试找到 JSON 对象的边界
+  const firstBrace = jsonStr.indexOf('{');
+  const lastBrace = jsonStr.lastIndexOf('}');
+  if (firstBrace !== -1 && lastBrace !== -1 && lastBrace > firstBrace) {
+    jsonStr = jsonStr.substring(firstBrace, lastBrace + 1);
+  }
+
+  // 策略 4: 处理 enhancedContent 中的特殊字符
+  // 由于 enhancedContent 可能包含 markdown，需要特殊处理
+  try {
+    return JSON.parse(jsonStr);
+  } catch (firstError) {
+    // 策略 5: 尝试修复常见的 JSON 问题
+    
+    // 5.1: 处理未转义的换行符
+    // 在 JSON 字符串值中，换行符应该是 \n 而不是实际的换行
+    // 但这很难处理，因为我们不知道哪些换行符在字符串值内
+    
+    // 5.2: 尝试提取关键字段
+    const isCompleteMatch = jsonStr.match(/"isComplete"\s*:\s*(true|false)/);
+    const reasonMatch = jsonStr.match(/"reason"\s*:\s*"([^"]*(?:\\.[^"]*)*)"/);
+    
+    if (isCompleteMatch) {
+      const isComplete = isCompleteMatch[1] === 'true';
+      const reason = reasonMatch ? reasonMatch[1].replace(/\\"/g, '"') : '无法提取原因';
+      
+      // 如果不完整，尝试提取 enhancedContent
+      let enhancedContent = null;
+      if (!isComplete) {
+        // 尝试找到 enhancedContent 的开始位置
+        const enhancedMatch = jsonStr.match(/"enhancedContent"\s*:\s*"/);
+        if (enhancedMatch) {
+          const startIdx = jsonStr.indexOf(enhancedMatch[0]) + enhancedMatch[0].length;
+          // 从这个位置开始，找到结束引号（考虑转义）
+          let endIdx = startIdx;
+          let inEscape = false;
+          for (let i = startIdx; i < jsonStr.length; i++) {
+            if (inEscape) {
+              inEscape = false;
+              continue;
+            }
+            if (jsonStr[i] === '\\') {
+              inEscape = true;
+              continue;
+            }
+            if (jsonStr[i] === '"') {
+              endIdx = i;
+              break;
+            }
+          }
+          if (endIdx > startIdx) {
+            enhancedContent = jsonStr.substring(startIdx, endIdx)
+              .replace(/\\n/g, '\n')
+              .replace(/\\"/g, '"')
+              .replace(/\\\\/g, '\\');
+          }
+        }
+      }
+
+      // 提取 missingItems
+      let missingItems = [];
+      const missingMatch = jsonStr.match(/"missingItems"\s*:\s*\[([\s\S]*?)\]/);
+      if (missingMatch) {
+        try {
+          missingItems = JSON.parse(`[${missingMatch[1]}]`);
+        } catch (e) {
+          // 尝试简单提取
+          const items = missingMatch[1].match(/"([^"]+)"/g);
+          if (items) {
+            missingItems = items.map(s => s.replace(/"/g, ''));
+          }
+        }
+      }
+
+      console.log('📋 使用备用解析策略提取了关键字段');
+      return {
+        isComplete,
+        reason,
+        missingItems,
+        enhancedContent,
+      };
+    }
+
+    // 如果所有策略都失败了，抛出原始错误
+    throw new Error(`JSON 解析失败: ${firstError.message}`);
+  }
+}
+
+/**
+ * 使用 AI 生成审核提示词（本地模式 - 读取本地文件）
  * @param {Object} aiClient - AI 客户端
  * @returns {Promise<Object>} 生成的配置
  */
@@ -24,22 +178,21 @@ export async function generateAIReviewGuardConfig(aiClient) {
     const messages = buildGenerateGuardPromptMessages(projectAnalysis);
     
     console.log('🔄 正在请求 AI 生成审核规则文档...\n');
+    console.log('📥 AI 实时响应:');
+    console.log('-'.repeat(60));
     
-    // 调用 AI 生成
-    const response = await aiClient.sendMessage(messages);
+    // 🎯 使用流式调用 AI 生成
+    const response = await aiClient.sendMessageStream(messages, (chunk) => {
+      if (chunk.content) {
+        process.stdout.write(chunk.content);
+      }
+    });
     
+    console.log('\n' + '-'.repeat(60));
     const generatedContent = response.content;
     
     console.log('✅ AI 已生成审核规则文档\n');
     
-    // 可选：保存到项目根目录
-    const saveToFile = process.env.AUTO_SAVE_REVIEWGUARD !== 'false'; // 默认保存
-    if (saveToFile) {
-      const savePath = path.join(process.cwd(), 'reviewguard.md');
-      fs.writeFileSync(savePath, generatedContent, 'utf-8');
-      console.log(`📝 已保存到: ${savePath}\n`);
-    }
-    
     return {
       type: 'markdown',
       filename: 'reviewguard.md (AI生成)',
@@ -53,6 +206,640 @@ export async function generateAIReviewGuardConfig(aiClient) {
   }
 }
 
+/**
+ * 🎯 使用 AI 生成审核提示词（GitLab API 模式 - 获取整个项目）
+ * @param {Object} aiClient - AI 客户端
+ * @param {Object} gitlabClient - GitLab 客户端
+ * @param {string} projectId - 项目 ID
+ * @param {string} ref - 分支名（默认 main）
+ * @returns {Promise<Object>} 生成的配置
+ */
+export async function generateAIReviewGuardConfigFromGitLab(aiClient, gitlabClient, projectId, ref = 'main') {
+  console.log('\n🤖 未找到 reviewguard.md 文件，正在通过 GitLab API 获取整个项目并生成审核提示词...\n');
+  
+  try {
+    // 通过 GitLab API 获取整个项目代码
+    const projectData = await gitlabClient.getFullProjectForAnalysis(projectId, ref);
+    
+    // 构建生成提示词的消息（使用全量文件）
+    const messages = buildGenerateGuardPromptMessagesFromFullProject(projectData);
+    
+    console.log('🔄 正在请求 AI 生成审核规则文档...\n');
+    console.log(`   发送给 AI 的项目信息：`);
+    console.log(`   - 文件数量: ${projectData.files.length}`);
+    console.log(`   - 总字符数: ${(projectData.stats.totalChars / 1000).toFixed(1)}K`);
+    console.log(`   - 技术栈: ${projectData.techStack.languages.join(', ') || '未知'}`);
+    console.log(`   - 框架: ${projectData.techStack.frameworks.join(', ') || '无'}\n`);
+    
+    console.log('📥 AI 实时响应:');
+    console.log('-'.repeat(60));
+    
+    // 🎯 使用流式调用 AI 生成
+    const response = await aiClient.sendMessageStream(messages, (chunk) => {
+      if (chunk.content) {
+        process.stdout.write(chunk.content);
+      }
+    });
+    
+    console.log('\n' + '-'.repeat(60));
+    const generatedContent = response.content;
+    
+    console.log('✅ AI 已生成审核规则文档\n');
+    
+    return {
+      type: 'markdown',
+      filename: 'reviewguard.md (AI从GitLab生成)',
+      content: generatedContent,
+      generated: true,
+      fromGitLab: true,
+    };
+  } catch (error) {
+    console.error('❌ 通过 GitLab API 生成审核提示词失败:', error.message);
+    console.log('⚠️  将使用默认审核规则\n');
+    return null;
+  }
+}
+
+/**
+ * 构建生成提示词消息（支持完整模式和轻量模式）
+ * @param {Object} projectData - 项目数据 { files, techStack, stats, directoryTree, fileList }
+ * @returns {Array} 消息数组
+ */
+function buildGenerateGuardPromptMessagesFromFullProject(projectData) {
+  const { files, techStack, stats, directoryTree, fileList } = projectData;
+  const isFullMode = stats.mode === 'full';
+  
+  let userMessage = `我需要你根据这个项目的${isFullMode ? '完整代码' : '信息'}，生成一份适合该项目的 AI 代码审查规则文档（reviewguard.md）。
+
+## 项目技术栈
+
+**编程语言**: ${techStack.languages.join(', ') || '未知'}
+**框架/库**: ${techStack.frameworks.join(', ') || '无'}
+**工具**: ${techStack.tools.join(', ') || '无'}
+
+## 项目统计
+
+- 配置文件数: ${stats.configFilesCount || 0}
+- 代码文件数: ${stats.sourceFilesCount || 0}
+- 分析的文件: ${stats.totalFiles || 0}
+- 总字符数: ${((stats.totalChars || 0) / 1000).toFixed(1)}K
+
+## 项目目录结构
+
+\`\`\`
+${directoryTree || '未提供'}
+\`\`\`
+
+## 项目文件列表
+
+共 ${fileList?.length || 0} 个文件：
+${fileList?.slice(0, 50).map(f => `- ${f}`).join('\n') || '未提供'}
+${fileList?.length > 50 ? `\n... 还有 ${fileList.length - 50} 个文件` : ''}
+
+## ${isFullMode ? '项目完整代码' : '关键配置文件和代码示例'}
+
+`;
+
+  // 按类型分组添加文件
+  const configFilesContent = files.filter(f => f.type === 'config');
+  const sourceFilesContent = files.filter(f => f.type === 'source');
+  const sampleFilesContent = files.filter(f => f.type === 'sample');
+
+  if (configFilesContent.length > 0) {
+    userMessage += `### 📦 配置文件\n\n`;
+    for (const file of configFilesContent) {
+      const ext = file.path.split('.').pop() || '';
+      userMessage += `#### ${file.path}\n\n\`\`\`${ext}\n${file.content}\n\`\`\`\n\n`;
+    }
+  }
+
+  // 🎯 完整模式：添加所有代码文件的完整内容
+  if (sourceFilesContent.length > 0) {
+    userMessage += `### 📝 代码文件（完整内容）\n\n`;
+    for (const file of sourceFilesContent) {
+      const ext = file.path.split('.').pop() || '';
+      const truncatedNote = file.truncated ? ' [已截断]' : '';
+      userMessage += `#### ${file.path}${truncatedNote}\n\n\`\`\`${ext}\n${file.content}\n\`\`\`\n\n`;
+    }
+  }
+
+  // 轻量模式：添加代码摘要
+  if (sampleFilesContent.length > 0) {
+    userMessage += `### 📝 代码示例（摘要）\n\n`;
+    for (const file of sampleFilesContent) {
+      const ext = file.path.split('.').pop() || '';
+      userMessage += `#### ${file.path}\n\n\`\`\`${ext}\n${file.content}\n\`\`\`\n\n`;
+    }
+  }
+
+  userMessage += `
+---
+
+## 请生成一份详细的 reviewguard.md 文档
+
+文档必须包含以下所有章节：
+
+### 1. 项目背景与概述
+- 项目名称和用途描述
+- 核心功能模块说明
+- 业务场景描述
+
+### 2. 技术栈详情
+- 前端框架（React/Vue/Angular 等）及版本
+- UI 组件库（如 Ant Design/Element Plus/Radix UI 等）
+- 状态管理方案（Redux/Zustand/Pinia 等）
+- 样式解决方案（Tailwind CSS/CSS Modules/Styled Components 等）
+- 构建工具（Vite/Webpack 等）
+- 代码质量工具（ESLint/Prettier 等）
+- 后端技术（如有）
+
+### 3. 项目结构说明
+- 目录结构树
+- 关键文件/目录说明
+- 模块划分逻辑
+
+### 4. 开发原则
+- 组件设计原则（如 Headless UI 原则）
+- 代码组织原则
+- 命名规范
+- 注释规范
+
+### 5. AI 代码审查规则（按类别分组，每个规则包含严重程度评分 1-10 分）
+
+#### 5.1 破坏性变更检查（严重程度 8-10 分）
+- 删除/重命名导出的函数、组件、类型
+- API 签名变更（参数、返回值）
+- 必须检查是否有其他文件引用
+
+#### 5.2 安全漏洞（严重程度 7-10 分）
+- XSS 注入风险
+- 敏感信息硬编码
+- 用户输入校验缺失
+
+#### 5.3 性能问题（严重程度 5-8 分）
+- 不必要的重渲染（React: 缺少 useMemo/useCallback）
+- 内存泄漏（未清理 subscriptions/timers）
+- 大列表未使用虚拟滚动
+
+#### 5.4 类型安全（严重程度 4-7 分）
+- 滥用 any 类型
+- 类型断言不安全
+- 缺少必要的类型定义
+
+#### 5.5 代码规范（严重程度 1-4 分）
+- 命名不规范
+- 魔法数字未定义为常量
+- 注释缺失或过期
+
+### 6. 回复格式规范（必须包含）
+
+\`\`\`
+【严重程度评分：X/10】
+
+📋 问题描述：
+具体说明发现的问题，一句话概括
+
+🔍 影响分析：
+• 当前文件：[具体影响]
+• 受影响的其他文件：[如有，列出文件名和行号]
+• 可能后果：[具体说明]
+
+💡 改进建议：
+1. [第一步具体操作]
+2. [第二步具体操作]
+3. [其他注意事项]
+\`\`\`
+
+### 7. 评论示例（必须包含至少 3 个不同场景）
+
+#### 示例 1：低风险问题（1-3 分）
+基于项目实际代码，给出一个命名规范或代码风格问题的示例
+
+#### 示例 2：中等风险问题（4-6 分）
+基于项目实际代码，给出一个性能问题或架构问题的示例
+
+#### 示例 3：高风险问题（7-10 分）
+基于项目实际代码，给出一个破坏性变更或安全问题的示例
+
+### 8. JSON 输出格式（用于 SDK 解析）
+
+\`\`\`json
+{
+  "reviews": [
+    {
+      "lineNumber": 15,
+      "isOldLine": false,
+      "hasIssue": true,
+      "comment": "【严重程度评分：8/10】\\n\\n📋 问题描述：..."
+    }
+  ]
+}
+\`\`\`
+
+**重要说明：**
+- 所有内容必须使用中文
+- 评论示例必须具体、真实，与项目技术栈相关
+- 规则要实用，能够发现真正的问题
+- 格式要统一，确保所有评论都遵循相同的规范`;
+
+  return [
+    {
+      role: 'system',
+      content: `你是一个专业的代码审查规范设计专家。
+
+## 你的任务
+根据项目的完整代码来分析项目特点，并生成针对性的、详细的代码审查规则文档。
+
+## 要求
+1. **内容要丰富**：不要只写空洞的规则，要结合项目实际代码给出具体的示例
+2. **示例要真实**：评论示例应该基于项目实际使用的技术栈，而不是通用示例
+3. **规则要实用**：审查规则应该针对项目特点，能够发现真正的问题
+4. **格式要统一**：确保所有评论都遵循相同的格式规范
+
+## 输出要求
+- 生成的文档必须使用中文
+- 必须包含所有要求的章节
+- 必须有至少 3 个具体的评论示例`
+    },
+    {
+      role: 'user',
+      content: userMessage
+    }
+  ];
+}
+
+/**
+ * 🎯 检查并补充现有的 reviewguard.md（智能补充模式）
+ * 结合项目代码判断现有规则是否完整，不完整则补充
+ * @param {Object} aiClient - AI 客户端
+ * @param {Object} gitlabClient - GitLab 客户端
+ * @param {string} projectId - 项目 ID
+ * @param {string} ref - 分支名
+ * @param {Object} existingGuard - 现有的 reviewguard 配置
+ * @returns {Promise<Object>} 检查/补充后的配置
+ */
+export async function checkAndEnhanceReviewGuard(aiClient, gitlabClient, projectId, ref, existingGuard) {
+  console.log('\n🔍 检查现有 reviewguard.md 是否完整...\n');
+  
+  try {
+    // 1. 获取项目完整代码
+    console.log('📡 通过 GitLab API 获取项目代码...');
+    const projectData = await gitlabClient.getFullProjectForAnalysis(projectId, ref);
+    
+    console.log(`   - 获取 ${projectData.files.length} 个文件`);
+    console.log(`   - 总计 ${(projectData.stats.totalChars / 1000).toFixed(1)}K 字符`);
+    console.log(`   - 技术栈: ${projectData.techStack.languages.join(', ') || '未知'}`);
+    console.log(`   - 框架: ${projectData.techStack.frameworks.join(', ') || '无'}\n`);
+    
+    // 2. 构建检查和补充的 prompt
+    const messages = buildCheckAndEnhancePromptMessages(existingGuard.content, projectData);
+    
+    console.log('🤖 请求 AI 分析并判断 reviewguard.md 是否完整...\n');
+    console.log('📥 AI 实时响应:');
+    console.log('-'.repeat(60));
+    
+    // 3. 🎯 使用流式调用 AI 分析
+    const response = await aiClient.sendMessageStream(messages, (chunk) => {
+      if (chunk.content) {
+        process.stdout.write(chunk.content);
+      }
+    });
+    
+    console.log('\n' + '-'.repeat(60));
+    const result = response.content;
+    
+    // 4. 解析 AI 返回结果
+    // 新格式：JSON 判断信息 + 可选的 ===ENHANCED_CONTENT_START=== ... ===ENHANCED_CONTENT_END=== 块
+    let analysisResult;
+    try {
+      // 尝试解析 JSON 部分
+      analysisResult = parseAIJsonResponse(result);
+      console.log('✅ 成功解析 AI 返回的判断信息');
+      console.log(`   - isComplete: ${analysisResult.isComplete}`);
+      console.log(`   - reason: ${analysisResult.reason?.substring(0, 100)}${analysisResult.reason?.length > 100 ? '...' : ''}`);
+      if (analysisResult.missingItems?.length > 0) {
+        console.log(`   - 缺失项: ${analysisResult.missingItems.slice(0, 5).join(', ')}${analysisResult.missingItems.length > 5 ? '...' : ''}`);
+      }
+
+      // 如果不完整，尝试提取增强内容
+      if (!analysisResult.isComplete && !analysisResult.enhancedContent) {
+        const enhancedContent = extractEnhancedContent(result);
+        if (enhancedContent) {
+          analysisResult.enhancedContent = enhancedContent;
+          console.log(`   ✅ 成功提取增强内容 (${(enhancedContent.length / 1000).toFixed(1)}K 字符)`);
+        }
+      }
+    } catch (e) {
+      console.log('⚠️  无法解析 AI 返回的 JSON:', e.message);
+      
+      // 尝试提取增强内容
+      const enhancedContent = extractEnhancedContent(result);
+      if (enhancedContent) {
+        console.log('📄 从特殊标记中提取到增强内容');
+        analysisResult = {
+          isComplete: false,
+          reason: 'JSON 解析失败，但提取到增强内容',
+          enhancedContent: enhancedContent,
+        };
+      } else if (result.includes('# ') && result.includes('## ')) {
+        // 如果看起来像 markdown 文档
+        console.log('📄 检测到 AI 返回了 Markdown 格式，将作为增强内容使用');
+        analysisResult = {
+          isComplete: false,
+          reason: 'AI 直接返回了增强后的文档',
+          enhancedContent: result,
+        };
+      } else {
+        console.log('⚠️  将直接使用现有的 reviewguard.md');
+        return existingGuard;
+      }
+    }
+    
+    // 5. 根据结果处理
+    if (analysisResult.isComplete) {
+      console.log('✅ reviewguard.md 已经比较完整，无需补充');
+      console.log(`   原因: ${analysisResult.reason}\n`);
+      
+      return {
+        ...existingGuard,
+        checked: true,
+        isComplete: true,
+        checkReason: analysisResult.reason,
+      };
+    } else {
+      console.log('📝 reviewguard.md 需要补充，正在增强...');
+      console.log(`   原因: ${analysisResult.reason}\n`);
+      
+      const enhancedContent = analysisResult.enhancedContent || existingGuard.content;
+      
+      return {
+        type: 'markdown',
+        filename: 'reviewguard.md (AI增强)',
+        content: enhancedContent,
+        checked: true,
+        isComplete: false,
+        enhanced: true,
+        checkReason: analysisResult.reason,
+      };
+    }
+  } catch (error) {
+    console.error('❌ 检查 reviewguard.md 失败:', error.message);
+    console.log('⚠️  将直接使用现有的 reviewguard.md\n');
+    return existingGuard;
+  }
+}
+
+/**
+ * 构建检查和补充 reviewguard.md 的 prompt
+ * @param {string} existingContent - 现有的 reviewguard.md 内容
+ * @param {Object} projectData - 项目数据
+ * @returns {Array} 消息数组
+ */
+function buildCheckAndEnhancePromptMessages(existingContent, projectData) {
+  const { files, techStack, stats } = projectData;
+  
+  let userMessage = `我有一个项目的代码审查规则文档（reviewguard.md），请你结合项目的实际代码，判断这个规则文档是否完整和准确。
+
+## 现有的 reviewguard.md 内容
+
+\`\`\`markdown
+${existingContent}
+\`\`\`
+
+## 项目技术栈
+
+**编程语言**: ${techStack.languages.join(', ') || '未知'}
+**框架/库**: ${techStack.frameworks.join(', ') || '无'}
+**工具**: ${techStack.tools.join(', ') || '无'}
+
+## 项目统计
+
+- 文件数量: ${stats.totalFiles}
+- 总代码量: ${(stats.totalChars / 1000).toFixed(1)}K 字符
+
+## 项目完整代码
+
+以下是项目的所有代码文件：
+
+`;
+
+  // 添加所有文件内容
+  for (const file of files) {
+    const ext = file.path.split('.').pop() || '';
+    userMessage += `
+### 📄 ${file.path}
+
+\`\`\`${ext}
+${file.content}
+\`\`\`
+
+`;
+  }
+
+  userMessage += `
+---
+
+## 请你完成以下任务：
+
+1. **分析项目代码**：仔细阅读项目的所有代码文件
+2. **对比现有规则**：检查现有的 reviewguard.md 是否覆盖了项目的关键特点
+3. **判断完整性**：
+
+   需要检查的方面：
+   - 是否有项目背景和概述
+   - 技术栈描述是否准确（框架、库、工具）
+   - 项目结构描述是否正确
+   - 代码审查规则是否涵盖项目实际使用的技术
+   - 是否有遗漏的重要审查规则
+   - 是否有具体的评论示例（不同严重程度的示例）
+   - 回复格式规范是否完整
+
+4. **输出结果**（必须严格按照以下格式）：
+
+**如果规则文档比较完整（无需补充）：**
+
+\`\`\`json
+{
+  "isComplete": true,
+  "reason": "简要说明为什么认为完整"
+}
+\`\`\`
+
+**如果规则文档不完整（需要补充）：**
+
+先输出判断信息：
+\`\`\`json
+{
+  "isComplete": false,
+  "reason": "简要说明缺少什么",
+  "missingItems": ["缺少项1", "缺少项2"]
+}
+\`\`\`
+
+然后输出增强后的完整文档（用特殊标记包裹）：
+\`\`\`
+===ENHANCED_CONTENT_START===
+（这里是补充完善后的完整 reviewguard.md 内容）
+===ENHANCED_CONTENT_END===
+\`\`\`
+
+## 📋 增强文档必须包含的内容（非常重要！）
+
+生成的 reviewguard.md 必须包含以下所有章节：
+
+### 1. 项目背景与概述
+- 项目名称和用途
+- 项目的核心功能模块
+- 项目的业务场景
+
+### 2. 技术栈详情
+- 前端框架（React/Vue/Angular 等）
+- UI 组件库（Ant Design/Element Plus/Radix UI 等）
+- 状态管理方案
+- 样式解决方案（Tailwind CSS/CSS Modules/Styled Components 等）
+- 构建工具（Vite/Webpack 等）
+- 代码质量工具（ESLint/Prettier 等）
+
+### 3. 项目结构说明
+- 目录结构
+- 关键文件说明
+- 模块划分
+
+### 4. 代码审查规则（按类别分组）
+每个规则必须包含：**严重程度评分（1-10分）**
+
+#### 4.1 破坏性变更检查（严重程度 8-10 分）
+- 删除/重命名导出的函数、组件、类型
+- API 签名变更
+- 必须检查是否有其他文件引用
+
+#### 4.2 安全漏洞（严重程度 7-10 分）
+- XSS 注入风险
+- 敏感信息硬编码
+- 用户输入校验
+
+#### 4.3 性能问题（严重程度 5-8 分）
+- 不必要的重渲染
+- 内存泄漏
+- 大列表优化
+
+#### 4.4 代码规范（严重程度 1-4 分）
+- 命名规范
+- 注释规范
+- 代码组织
+
+### 5. 回复格式规范（必须包含）
+
+\`\`\`
+【严重程度评分：X/10】
+
+📋 问题描述：
+具体说明发现的问题
+
+🔍 影响分析：
+• 当前文件：[具体影响]
+• 受影响的其他文件：[如有]
+• 可能后果：[具体说明]
+
+💡 改进建议：
+1. [第一步具体操作]
+2. [第二步具体操作]
+\`\`\`
+
+### 6. 评论示例（必须包含至少 3 个不同场景的示例）
+
+#### 示例 1：低风险问题（1-3 分）
+\`\`\`
+【严重程度评分：2/10】
+
+📋 问题描述：
+变量名 user_name 不符合 camelCase 命名规范
+
+🔍 影响分析：
+• 当前文件：不影响功能运行
+• 受影响的其他文件：无
+• 可能后果：影响代码可读性
+
+💡 改进建议：
+1. 将 user_name 改为 userName
+2. 检查同一文件中其他变量命名
+\`\`\`
+
+#### 示例 2：中等风险问题（4-6 分）
+（提供一个具体的中等风险示例）
+
+#### 示例 3：高风险问题（7-10 分）
+（提供一个具体的高风险示例，如删除正在使用的函数）
+
+### 7. JSON 输出格式（用于 SDK 解析）
+
+\`\`\`json
+{
+  "reviews": [
+    {
+      "lineNumber": 15,
+      "isOldLine": false,
+      "hasIssue": true,
+      "comment": "【严重程度评分：8/10】\\n\\n📋 问题描述：..."
+    }
+  ]
+}
+\`\`\`
+
+**重要说明：**
+- JSON 中不要包含 enhancedContent 字段
+- 增强内容必须用 ===ENHANCED_CONTENT_START=== 和 ===ENHANCED_CONTENT_END=== 包裹
+- 增强内容必须是完整的 markdown 文档，不是增量
+- 必须保留原有内容的精华，并补充缺失部分
+- 所有内容必须使用中文
+- 评论示例必须具体、真实，与项目技术栈相关`;
+
+  return [
+    {
+      role: 'system',
+      content: `你是一个专业的代码审查规范专家。你的任务是分析项目代码，检查现有的代码审查规则文档是否完整和准确。
+
+## 你的职责
+
+1. 仔细阅读项目代码，深入理解项目的技术栈、架构和业务场景
+2. 对比现有的规则文档，找出不准确或缺失的部分
+3. 如果规则文档不完整，提供补充后的完整文档
+
+## 判断"完整"的标准
+
+文档必须包含以下所有内容才能算"完整"：
+- ✅ 项目背景和概述（项目用途、核心功能）
+- ✅ 准确的技术栈描述（框架、库、工具）
+- ✅ 项目结构说明
+- ✅ 分类的代码审查规则（包含严重程度评分）
+- ✅ 统一的回复格式规范
+- ✅ 至少 3 个具体的评论示例（低/中/高风险）
+- ✅ JSON 输出格式说明
+
+## 重要原则
+
+1. **内容要丰富**：不要只写空洞的规则，要结合项目实际代码给出具体的示例
+2. **示例要真实**：评论示例应该基于项目实际使用的技术栈，而不是通用示例
+3. **规则要实用**：审查规则应该针对项目特点，能够发现真正的问题
+4. **格式要统一**：确保所有评论都遵循相同的格式规范
+
+## 评分参考
+
+- 缺少项目背景：-20%
+- 缺少技术栈描述：-20%
+- 缺少审查规则分类：-20%
+- 缺少评论示例：-20%
+- 缺少格式规范：-20%
+
+如果总分低于 80%，则认为"不完整"，需要补充。`
+    },
+    {
+      role: 'user',
+      content: userMessage
+    }
+  ];
+}
+
 /**
  * 读取项目根目录下的 AI Review Guard 配置文件
  * @param {Object} aiClient - AI 客户端（可选，用于生成配置）