@umsai/ums-code 0.6.0-v1 → 0.10.5-v2

package/dist/src/ui/commands/reviewCommand.js

@@ -1,2046 +0,0 @@
-/**
- * Review Command - 智能代码评审命令
- *
- * 提供多模式代码评审功能，支持智能分批处理和文件过滤
- *
- * @module reviewCommand
- */
-import { CommandKind } from './types.js';
-import { simpleGit } from 'simple-git';
-import { resolve } from 'path';
-// ============================================================================
-// 常量配置
-// ============================================================================
-const REVIEW_THRESHOLDS = {
-    /** 超过此数量的文件被认为是大型变更 */
-    LARGE_FILE_THRESHOLD: 50,
-    /** 超过此数量的行变更被认为是大型变更 */
-    LARGE_CHANGE_THRESHOLD: 3000,
-    /** 每批最多处理的文件数 */
-    MAX_FILES_PER_BATCH: 20,
-    /** 每批最多处理的行变更数 */
-    MAX_CHANGES_PER_BATCH: 2000,
-};
-const COMMIT_HASH_PATTERN = /^[0-9a-f]{7,}$/i;
-// ============================================================================
-// 错误类型
-// ============================================================================
-class ReviewCommandError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.name = 'ReviewCommandError';
-        this.code = code;
-    }
-}
-// ============================================================================
-// 工具类
-// ============================================================================
-/**
- * Git 操作工具类
- */
-class GitUtils {
-    /**
-     * 检测字符串是否像 commit hash（至少7位十六进制字符）
-     */
-    static looksLikeCommitHash(str) {
-        return COMMIT_HASH_PATTERN.test(str);
-    }
-    /**
-     * 根据 review 模式构建 git comparison 字符串
-     */
-    static buildComparisonString(options, format = 'command') {
-        const { mode, commit1, commit2, branch1, branch2 } = options;
-        const separator = format === 'range' ? '..' : ' ';
-        switch (mode) {
-            case 'default':
-                return 'HEAD';
-            case 'commit':
-                if (commit2) {
-                    return `${commit1}${separator}${commit2}`;
-                }
-                return `${commit1}^${separator}${commit1}`;
-            case 'branch':
-                if (branch2) {
-                    return `${branch1}${separator}${branch2}`;
-                }
-                return `main${separator}${branch1}`;
-            case 'commits':
-                // commits 模式不使用此方法，每个文件单独构建命令
-                throw new ReviewCommandError('Commits mode should not use buildComparisonString');
-            default:
-                throw new ReviewCommandError(`Unknown review mode: ${mode}`);
-        }
-    }
-    /**
-     * 构建单个文件的 git diff 命令（用于 commits 模式）
-     */
-    static buildFileDiffCommand(fileChange) {
-        if (fileChange.commit) {
-            // 单个 commit
-            return `git diff ${fileChange.commit}^ ${fileChange.commit} -- ${fileChange.filePath}`;
-        }
-        else if (fileChange.commit1 && fileChange.commit2) {
-            // 两个 commit
-            return `git diff ${fileChange.commit1}^ ${fileChange.commit2} -- ${fileChange.filePath}`;
-        }
-        else {
-            throw new ReviewCommandError('Invalid file change: missing commit information');
-        }
-    }
-    /**
-     * 构建 git diff --stat 命令
-     */
-    static buildDiffStatCommand(options) {
-        const comparison = this.buildComparisonString(options, 'command');
-        return `git diff --stat ${comparison}`;
-    }
-    /**
-     * 构建 git diff 命令
-     */
-    static buildDiffCommand(options) {
-        const comparison = this.buildComparisonString(options, 'command');
-        return `git diff ${comparison}`;
-    }
-    /**
-     * 构建 git diff 参数数组
-     */
-    static buildDiffArgs(options, command) {
-        const baseArgs = command === 'diff-stat'
-            ? ['diff', '--stat']
-            : ['diff', '--name-only'];
-        const comparison = this.buildComparisonString(options, 'range');
-        return [...baseArgs, comparison];
-    }
-}
-// ============================================================================
-// 参数解析器
-// ============================================================================
-/**
- * Review 命令参数解析器
- */
-class ReviewArgumentParser {
-    /**
-     * 解析 review 命令的参数
-     */
-    static parse(args) {
-        const trimmedArgs = args.trim();
-        if (!trimmedArgs) {
-            return { mode: 'default' };
-        }
-        const parts = trimmedArgs.split(/\s+/);
-        // 提取 --prompt-enhance 和 --notice 参数
-        const enhanceOptions = this.extractEnhanceOption(parts);
-        const noticeOption = this.extractNoticeOption(parts);
-        const filteredParts = this.removeOptions(parts);
-        if (filteredParts.length === 0) {
-            return { mode: 'default', ...enhanceOptions, ...noticeOption };
-        }
-        const command = filteredParts[0];
-        switch (command) {
-            case '-commit':
-                return { ...this.parseCommitMode(filteredParts), ...enhanceOptions, ...noticeOption };
-            case '-branch':
-                return { ...this.parseBranchMode(filteredParts), ...enhanceOptions, ...noticeOption };
-            case '-commits':
-                return { ...this.parseCommitsMode(filteredParts), ...enhanceOptions, ...noticeOption };
-            default:
-                return { ...this.handleUnknownCommand(filteredParts), ...enhanceOptions, ...noticeOption };
-        }
-    }
-    /**
-     * 提取 --prompt-enhance 参数
-     */
-    static extractEnhanceOption(parts) {
-        for (let i = 0; i < parts.length; i++) {
-            if (parts[i] === '--prompt-enhance' && i + 1 < parts.length) {
-                return { promptEnhancePath: parts[i + 1] };
-            }
-        }
-        return {};
-    }
-    /**
-     * 移除所有选项参数（--prompt-enhance 和 --notice）
-     */
-    static removeOptions(parts) {
-        const filtered = [];
-        for (let i = 0; i < parts.length; i++) {
-            if (parts[i] === '--prompt-enhance') {
-                i++; // 跳过参数值
-            }
-            else if (parts[i] === '--notice') {
-                // 跳过该标志
-            }
-            else {
-                filtered.push(parts[i]);
-            }
-        }
-        return filtered;
-    }
-    /**
-     * 提取 --notice 参数
-     */
-    static extractNoticeOption(parts) {
-        return { notice: parts.includes('--notice') };
-    }
-    /**
-     * 解析 commit 模式参数
-     */
-    static parseCommitMode(parts) {
-        if (parts.length < 2) {
-            throw new ReviewCommandError('Commit mode requires at least one commit hash', 'MISSING_COMMIT_HASH');
-        }
-        return {
-            mode: 'commit',
-            commit1: parts[1],
-            commit2: parts[2],
-        };
-    }
-    /**
-     * 解析 branch 模式参数
-     */
-    static parseBranchMode(parts) {
-        if (parts.length < 2) {
-            throw new ReviewCommandError('Branch mode requires at least one branch name', 'MISSING_BRANCH_NAME');
-        }
-        return {
-            mode: 'branch',
-            branch1: parts[1],
-            branch2: parts[2],
-        };
-    }
-    /**
-     * 解析 commits 模式参数
-     */
-    static parseCommitsMode(parts) {
-        if (parts.length < 2) {
-            throw new ReviewCommandError('Commits mode requires commit hashes', 'MISSING_COMMITS');
-        }
-        // 解析逗号分隔的 commit 列表
-        const commitsString = parts[1];
-        const commits = commitsString.split(',').map(c => c.trim()).filter(c => c.length > 0);
-        if (commits.length < 2) {
-            throw new ReviewCommandError('Commits mode requires at least 2 commit hashes (comma-separated)', 'INSUFFICIENT_COMMITS');
-        }
-        return {
-            mode: 'commits',
-            commits,
-        };
-    }
-    /**
-     * 处理未知命令或可能的语法错误
-     */
-    static handleUnknownCommand(parts) {
-        // 检测是否忘记添加 -commit 或 -branch 参数
-        if (parts.length >= 1 && GitUtils.looksLikeCommitHash(parts[0])) {
-            throw new ReviewCommandError(this.buildUsageErrorMessage(parts[0], parts[1]), 'INVALID_SYNTAX');
-        }
-        // 默认模式
-        return { mode: 'default' };
-    }
-    /**
-     * 构建使用错误提示信息
-     */
-    static buildUsageErrorMessage(commitHash, secondArg) {
-        const example = secondArg
-            ? `/review -commit ${commitHash} ${secondArg}`
-            : `/review -commit ${commitHash}`;
-        return `Invalid syntax. Did you forget '-commit'?
-
-Usage:
-  /review -commit <commit1> [commit2]
-  /review -branch <branch1> [branch2]
-  /review  (for uncommitted changes)
-
-Example:
-  ${example}`;
-    }
-}
-// ============================================================================
-// Git 统计分析器
-// ============================================================================
-/**
- * Git 统计分析器
- */
-class GitStatsAnalyzer {
-    /**
-     * 获取 git diff 统计信息
-     */
-    static async getDiffStats(projectRoot, options) {
-        const git = this.createGitInstance(projectRoot);
-        try {
-            const diffArgs = GitUtils.buildDiffArgs(options, 'diff-stat');
-            const statsOutput = await git.raw(diffArgs);
-            return this.parseStatsOutput(statsOutput);
-        }
-        catch (error) {
-            throw new ReviewCommandError(`Failed to get git diff stats: ${error instanceof Error ? error.message : String(error)}`, 'GIT_STATS_ERROR');
-        }
-    }
-    /**
-     * 创建 Git 实例
-     */
-    static createGitInstance(projectRoot) {
-        return simpleGit(projectRoot, {
-            binary: 'git',
-            maxConcurrentProcesses: 1,
-        });
-    }
-    /**
-     * 解析 git diff --stat 输出
-     */
-    static parseStatsOutput(statsOutput) {
-        const lines = statsOutput.trim().split('\n');
-        if (lines.length === 0 || !lines[0]) {
-            return this.createEmptyStats();
-        }
-        const fileCount = this.calculateFileCount(lines);
-        const { addedLines, deletedLines } = this.calculateLineChanges(lines);
-        return {
-            fileCount,
-            addedLines,
-            deletedLines,
-            totalChanges: addedLines + deletedLines,
-        };
-    }
-    /**
-     * 创建空的统计对象
-     */
-    static createEmptyStats() {
-        return {
-            fileCount: 0,
-            addedLines: 0,
-            deletedLines: 0,
-            totalChanges: 0,
-        };
-    }
-    /**
-     * 计算文件数量
-     */
-    static calculateFileCount(lines) {
-        return lines.length > 1 ? lines.length - 1 : 0;
-    }
-    /**
-     * 计算行变更统计
-     */
-    static calculateLineChanges(lines) {
-        let addedLines = 0;
-        let deletedLines = 0;
-        for (const line of lines) {
-            const lineStats = this.parseLineStats(line);
-            if (lineStats) {
-                addedLines += lineStats.addedLines;
-                deletedLines += lineStats.deletedLines;
-            }
-        }
-        return { addedLines, deletedLines };
-    }
-    /**
-     * 解析单行统计信息
-     * 匹配格式：'file.ts | 10 ++++------'
-     */
-    static parseLineStats(line) {
-        const match = line.match(/\|\s*(\d+)\s*([+-]+)?/);
-        if (!match)
-            return null;
-        const totalChanges = parseInt(match[1], 10);
-        const signs = match[2] || '';
-        const additions = (signs.match(/\+/g) || []).length;
-        const deletions = (signs.match(/-/g) || []).length;
-        if (additions === 0 && deletions === 0) {
-            // 如果没有符号，估算各占一半
-            return {
-                addedLines: Math.floor(totalChanges / 2),
-                deletedLines: Math.ceil(totalChanges / 2),
-            };
-        }
-        // 按比例计算实际行数
-        const total = additions + deletions;
-        return {
-            addedLines: Math.round((additions / total) * totalChanges),
-            deletedLines: Math.round((deletions / total) * totalChanges),
-        };
-    }
-}
-// ============================================================================
-// 多 Commit 分析器
-// ============================================================================
-/**
- * 多 Commit 文件变更分析器
- */
-class MultiCommitAnalyzer {
-    /**
-     * 分析多个 commit 的文件变更
-     */
-    static async analyzeCommits(projectRoot, commits) {
-        const git = this.createGitInstance(projectRoot);
-        // 步骤1：收集所有commit的变更文件
-        const fileCommitMap = new Map();
-        for (const commit of commits) {
-            const files = await this.getChangedFiles(git, commit);
-            for (const file of files) {
-                if (!fileCommitMap.has(file)) {
-                    fileCommitMap.set(file, []);
-                }
-                fileCommitMap.get(file).push(commit);
-            }
-        }
-        // 步骤2：构建 changeList
-        const changeList = [];
-        fileCommitMap.forEach((commitList, filePath) => {
-            if (commitList.length === 1) {
-                // 只在一个 commit 中修改
-                changeList.push({
-                    filePath,
-                    commit: commitList[0],
-                });
-            }
-            else {
-                // 在多个 commit 中修改，保留第一个和最后一个
-                changeList.push({
-                    filePath,
-                    commit1: commitList[0],
-                    commit2: commitList[commitList.length - 1],
-                });
-            }
-        });
-        // 步骤3：统计每个文件的变更行数
-        let totalAddedLines = 0;
-        let totalDeletedLines = 0;
-        for (const fileChange of changeList) {
-            const { addedLines, deletedLines } = await this.getFileStats(git, fileChange);
-            fileChange.modifyLines = addedLines + deletedLines;
-            totalAddedLines += addedLines;
-            totalDeletedLines += deletedLines;
-        }
-        // 构建统计信息
-        const stats = {
-            fileCount: changeList.length,
-            addedLines: totalAddedLines,
-            deletedLines: totalDeletedLines,
-            totalChanges: totalAddedLines + totalDeletedLines,
-        };
-        return { changeList, stats };
-    }
-    /**
-     * 获取单个 commit 的变更文件列表
-     */
-    static async getChangedFiles(git, commit) {
-        try {
-            const output = await git.raw(['diff', '--name-only', `${commit}^`, commit]);
-            return output
-                .trim()
-                .split('\n')
-                .filter(line => line.length > 0);
-        }
-        catch (error) {
-            throw new ReviewCommandError(`Failed to get changed files for commit ${commit}: ${error instanceof Error ? error.message : String(error)}`, 'GIT_DIFF_ERROR');
-        }
-    }
-    /**
-     * 获取单个文件的变更统计
-     */
-    static async getFileStats(git, fileChange) {
-        try {
-            let output;
-            if (fileChange.commit) {
-                // 单个 commit
-                output = await git.raw([
-                    'diff',
-                    '--stat',
-                    `${fileChange.commit}^`,
-                    fileChange.commit,
-                    '--',
-                    fileChange.filePath,
-                ]);
-            }
-            else if (fileChange.commit1 && fileChange.commit2) {
-                // 两个 commit
-                output = await git.raw([
-                    'diff',
-                    '--stat',
-                    `${fileChange.commit1}^`,
-                    fileChange.commit2,
-                    '--',
-                    fileChange.filePath,
-                ]);
-            }
-            else {
-                return { addedLines: 0, deletedLines: 0 };
-            }
-            // 解析统计输出
-            return this.parseFileStatOutput(output);
-        }
-        catch (_error) {
-            // 如果获取失败，返回0
-            return { addedLines: 0, deletedLines: 0 };
-        }
-    }
-    /**
-     * 解析文件的统计输出
-     */
-    static parseFileStatOutput(output) {
-        const lines = output.trim().split('\n');
-        if (lines.length === 0) {
-            return { addedLines: 0, deletedLines: 0 };
-        }
-        // 查找包含统计信息的行
-        for (const line of lines) {
-            const match = line.match(/\|\s*(\d+)\s*([+-]+)?/);
-            if (match) {
-                const totalChanges = parseInt(match[1], 10);
-                const signs = match[2] || '';
-                const additions = (signs.match(/\+/g) || []).length;
-                const deletions = (signs.match(/-/g) || []).length;
-                if (additions === 0 && deletions === 0) {
-                    return {
-                        addedLines: Math.floor(totalChanges / 2),
-                        deletedLines: Math.ceil(totalChanges / 2),
-                    };
-                }
-                const total = additions + deletions;
-                return {
-                    addedLines: Math.round((additions / total) * totalChanges),
-                    deletedLines: Math.round((deletions / total) * totalChanges),
-                };
-            }
-        }
-        return { addedLines: 0, deletedLines: 0 };
-    }
-    /**
-     * 创建 Git 实例
-     */
-    static createGitInstance(projectRoot) {
-        return simpleGit(projectRoot, {
-            binary: 'git',
-            maxConcurrentProcesses: 1,
-        });
-    }
-}
-// ============================================================================
-// Prompt 构建器
-// ============================================================================
-/**
- * 代码评审 Prompt 构建器
- */
-class ReviewPromptBuilder {
-    /**
-     * 构建小型变更的评审 prompt
-     */
-    static buildSmallChangePrompt(stats, projectRoot, gitDiffCommand, options) {
-        return this.buildPromptTemplate([
-            this.buildHeader(stats),
-            this.buildExecutionFlow(options),
-            this.buildFileFilteringPhase(projectRoot, gitDiffCommand),
-            this.buildCodeReviewPhase(projectRoot, gitDiffCommand, options),
-            this.buildReportGenerationPhase(stats),
-            this.buildQualityCheckPhase(projectRoot, options),
-            this.buildCallToAction()
-        ]);
-    }
-    /**
-     * 构建大型变更的评审 prompt
-     */
-    static buildLargeChangePrompt(stats, projectRoot, gitDiffStatCommand, options) {
-        return this.buildPromptTemplate([
-            this.buildLargeChangeHeader(stats),
-            this.buildLargeChangeExecutionFlow(options),
-            this.buildAnalysisPhase(projectRoot, gitDiffStatCommand),
-            this.buildBatchReviewPhase(projectRoot, options),
-            this.buildSummaryPhase(stats, projectRoot, options),
-            this.buildLargeChangeCallToAction()
-        ]);
-    }
-    /**
-     * 构建 commits 模式小型变更的评审 prompt
-     */
-    static buildCommitsSmallChangePrompt(stats, projectRoot, changeList, options) {
-        return this.buildPromptTemplate([
-            this.buildCommitsHeader(stats, changeList),
-            this.buildExecutionFlow(options),
-            this.buildCommitsFileFilteringPhase(projectRoot, changeList),
-            this.buildCommitsCodeReviewPhase(projectRoot, changeList, options),
-            this.buildReportGenerationPhase(stats),
-            this.buildQualityCheckPhase(projectRoot, options),
-            this.buildCallToAction()
-        ]);
-    }
-    /**
-     * 构建 commits 模式大型变更的评审 prompt
-     */
-    static buildCommitsLargeChangePrompt(stats, projectRoot, changeList, options) {
-        return this.buildPromptTemplate([
-            this.buildCommitsLargeChangeHeader(stats, changeList),
-            this.buildLargeChangeExecutionFlow(options),
-            this.buildCommitsAnalysisPhase(projectRoot, changeList),
-            this.buildCommitsBatchReviewPhase(projectRoot, changeList, options),
-            this.buildSummaryPhase(stats, projectRoot, options),
-            this.buildLargeChangeCallToAction()
-        ]);
-    }
-    /**
-     * 构建 prompt 模板
-     */
-    static buildPromptTemplate(sections) {
-        return sections.join('\n\n---\n\n');
-    }
-    /**
-     * 构建变更摘要头部
-     */
-    static buildHeader(stats) {
-        return `# 代码评审任务
-
-## 变更摘要
-
-- **文件总数**: ${stats.fileCount} 个
-- **新增行数**: ${stats.addedLines} 行
-- **删除行数**: ${stats.deletedLines} 行
-- **总变更量**: ${stats.totalChanges} 行
-
-变更规模适中，将使用 code-reviewer 一次性完成评审。`;
-    }
-    /**
-     * 构建大型变更头部
-     */
-    static buildLargeChangeHeader(stats) {
-        return `# 代码评审任务 - 大型变更检测
-
-## 变更摘要
-
-- **文件总数**: ${stats.fileCount} 个
-- **新增行数**: ${stats.addedLines} 行
-- **删除行数**: ${stats.deletedLines} 行
-- **总变更量**: ${stats.totalChanges} 行
-
-由于这是一个**大型变更**（超过 ${REVIEW_THRESHOLDS.LARGE_FILE_THRESHOLD} 个文件或 ${REVIEW_THRESHOLDS.LARGE_CHANGE_THRESHOLD} 行代码），需要分批次进行评审。`;
-    }
-    /**
-     * 构建执行流程
-     */
-    static buildExecutionFlow(options) {
-        const tasks = [
-            '1. AI 智能文件过滤',
-            '2. AI 智能代码评审',
-            '3. 生成评审报告',
-            '4. 评审报告质量检查'
-        ];
-        if (options?.notice) {
-            tasks.push('5. 生成完成标志文件');
-        }
-        return `## 执行流程
-
-请使用 **TodoWrite** 工具创建并跟踪以下任务：
-
-\`\`\`
-${tasks.join('\n')}
-\`\`\``;
-    }
-    /**
-     * 构建大型变更执行流程
-     */
-    static buildLargeChangeExecutionFlow(options) {
-        const noticeTask = options?.notice ? '\n6. 生成完成标志文件' : '';
-        return `## 执行流程（分三个阶段）
-
-### 阶段一：智能分析与过滤
-
-请使用 **TodoWrite** 创建初始任务列表：
-
-\`\`\`
-1. 分析变更文件
-2. AI 智能文件过滤
-3. AI 智能制定分批次评审策略
-4. 复核分批次评审策略
-5. [后续任务待分批完成后添加]${noticeTask}
-\`\`\``;
-    }
-    /**
-     * 构建文件过滤阶段
-     */
-    static buildFileFilteringPhase(projectRoot, gitDiffCommand) {
-        return `## 第一阶段：AI 智能文件过滤
-
-### 步骤 1：获取变更文件列表并进行智能过滤
-
-执行以下 bash 命令获取变更文件统计：
-
-\`\`\`bash
-cd ${projectRoot}
-git diff --stat ${gitDiffCommand.replace('git diff', '').trim()}
-\`\`\`
-
-**然后对变更文件进行 AI 智能过滤分析**：
-
-${this.buildFileFilteringRules()}
-
-${this.buildFileFilteringOutputFormat()}
-
-### 步骤 2：检查过滤结果
-
-**重要**：如果所有文件都被过滤掉（需要评审的文件为 0），则：
-1. 输出消息："✅ 本次变更无需代码评审（全部为文档、配置或自动生成文件）"
-2. 创建简单的 CODE_REVIEW.md 文件说明情况
-3. 结束评审流程
-
-如果还有需要评审的文件，继续下一步。`;
-    }
-    /**
-     * 构建文件过滤规则
-     */
-    static buildFileFilteringRules() {
-        return `**过滤原则**：
-1. **需要评审的文件**：
-   - 所有源代码文件（.java, .ts, .js, .py, .go, .rs, etc.）
-   - 配置文件（特别是涉及权限、安全、路由的配置）
-   - SQL/数据库迁移文件
-   - API定义文件（OpenAPI, GraphQL schemas）
-   - 关键的构建脚本（如果包含复杂逻辑）
-
-2. **可以过滤掉的文件**：
-   - 纯文档文件（README.md, CHANGELOG.md等，除非是技术文档）
-   - 依赖锁文件（package-lock.json, yarn.lock, Cargo.lock等）
-   - 二进制文件和媒体文件（图片、字体、音视频等）
-   - 自动生成的代码（如果有明确标记）
-   - 构建产物和编译输出
-   - IDE配置文件（.vscode, .idea等）
-   - Git相关配置（.gitignore, .gitattributes）
-
-3. **不确定时的策略**：
-   - 当无法确定文件类型或用途时，**倾向于包含而不是排除**
-   - 对于混合内容（如包含代码示例的markdown），考虑保留
-   - 对于小文件（<50行），包含成本低，可以保留`;
-    }
-    /**
-     * 构建文件过滤输出格式
-     */
-    static buildFileFilteringOutputFormat() {
-        return `**请使用以下格式输出过滤结果**：
-
-\`\`\`markdown
-## 文件过滤分析
-
-### 需要评审的文件（共 X 个，约 Y 行变更）
-
-1. [文件路径] - [变更行数] 行变更
-2. [文件路径] - [变更行数] 行变更
-...
-
-### 已过滤的文件（共 Z 个）
-
-**[类别名称]（N个）**：
-- [文件路径] - [过滤原因]
-...
-
-### 统计
-- 原始变更文件总数：X 个
-- 需要评审：X 个（Y%）
-- 已过滤：Z 个（W%）
-- 预计需要评审的代码行数：约 N 行
-\`\`\``;
-    }
-    /**
-     * 构建代码评审阶段
-     */
-    static buildCodeReviewPhase(projectRoot, gitDiffCommand, options) {
-        return `## 第二阶段：执行代码评审
-
-### 步骤 3：AI 智能代码评审
-
-使用 **Task tool** 调用 code-reviewer subagent，**仅对需要评审的文件进行评审**：
-
-\`\`\`typescript
-{
-  subagent_type: 'code-reviewer',
-  description: '代码评审 - 完整变更',
-  prompt: \`${this.buildSubagentPrompt(projectRoot, gitDiffCommand, options)}\`
-}
-\`\`\`
-
-### 步骤 4：等待评审完成
-
-subagent 会自动：
-1. 执行 git diff 命令获取变更内容
-2. 使用 Read tool 读取相关文件（重点关注需要评审的文件）
-3. 按照六个维度进行深度代码评审
-4. 进行自我检查确保评审质量`;
-    }
-    /**
-     * 构建附加规则部分
-     */
-    static buildEnhancedRulesSection(projectRoot, options) {
-        // 构建附加规则文件列表
-        const enhancedRules = [];
-        enhancedRules.push(`${projectRoot}/UMS.md`);
-        if (options?.promptEnhancePath) {
-            enhancedRules.push(resolve(projectRoot, options.promptEnhancePath));
-        }
-        return enhancedRules.length > 0 ? `
-## 附加规则
-
-尝试读取以下文件（如果文件不存在则跳过）：
-
-${enhancedRules.map(file => `- ${file}`).join('\n')}
-
-从这些文件中提取开发规范、编码标准和评审规则，作为附加规则。
-
-如果代码违反了附加规则，将其报告为问题并给出适当的严重性和维度。
-
-` : '';
-    }
-    /**
-     * 构建 subagent prompt
-     */
-    static buildSubagentPrompt(projectRoot, gitDiffCommand, options) {
-        return `请按照你的标准评审流程进行全面代码评审。
-
-## 变更信息
-
-- 需要评审的文件：X 个
-- 变更行数：约 Y 行
-
-## 需要评审的文件列表
-
-- file1.ts
-- file2.ts
-- file3.ts
-...
-
-## 获取变更内容
-
-请执行以下命令获取代码变更：
-
-\\\`\\\`\\\`bash
-cd ${projectRoot}
-${gitDiffCommand} -- file1.ts file2.ts file3.ts
-\\\`\\\`\\\`
-
-（将 file1.ts file2.ts file3.ts 替换为实际的批次文件列表）
-
-${this.buildEnhancedRulesSection(projectRoot, options)}
-
-## 结果检查
-
-在返回结果前，要确保：
-
-1. 已评审所有指定文件
-
-如果有遗漏、未评审的文件， 请补充评审
-
-2. 每个问题都在 diff 中明确存在
-3. 没有基于"理论上可能"的问题
-4. 没有报告已被处理/修复的问题
-5. 问题是真实存在，不是幻觉、"挑毛病"
-
-如果有误报的问题，请剔除
-
-6. 每个问题都有 [严重性][维度] 标签
-7. CRITICAL/HIGH 有：问题描述、详细分析、当前代码、建议修复
-8. MEDIUM/LOW 有：问题描述、简要说明
-9. 问题严重性符合 SEVERITY_GUIDELINES
-10. 问题维度符合 REVIEW_DIMENSIONS
-
-如果有描述不当或者信息缺失的报告问题，请调整修正
-
-**质量标准**：
-- ✅ 宁可 5 个准确问题，不要 10 个含 3 个误报
-- ✅ 准确性 > 完整性
-- ✅ 不确定时：不报告或降低严重性`;
-    }
-    /**
-     * 构建报告生成阶段
-     */
-    static buildReportGenerationPhase(stats) {
-        return `## 第三阶段：生成最终报告
-
-### 步骤 5：整理评审结果并生成报告
-
-获取 subagent 的评审结果后，按照以下结构生成最终的评审报告，写入 \`CODE_REVIEW.md\`：
-
-${this.buildReportTemplate(stats)}
-
-**重要提示**
-- 请**逐条提取**所有评审问题，不要总结或遗漏任何细节
-- **每个问题必须包含文件路径**（从 subagent 输出中提取）
-- 保持原始的代码示例、分析和修复建议的完整性
-- 如果某个严重性级别下某个维度没有问题，则跳过该小节
-- 确保统计表中的数字与实际问题数量一致`;
-    }
-    /**
-     * 构建报告模板
-     */
-    static buildReportTemplate(stats) {
-        return `\`\`\`markdown
-# 代码评审报告
-
-## 变更概览
-
-- **原始文件总数**: ${stats.fileCount} 个
-- **评审文件数**: X 个（Y% 需要评审）
-- **过滤文件数**: Z 个（W% 无需评审）
-- **新增行数**: ${stats.addedLines} 行
-- **删除行数**: ${stats.deletedLines} 行
-- **总变更量**: ${stats.totalChanges} 行
-
-本次变更主要涉及 [简要概括主要变更内容]。
-
----
-
-## 📋 问题统计
-
-| 严重性 | 正确性 | 安全性 | 性能 | 可维护性 | 架构设计 | 最佳实践 | 合计 |
-|--------|--------|--------|------|----------|----------|----------|------|
-| 🚨 CRITICAL | X | X | X | X | X | X | **X** |
-| ⚠️ HIGH | X | X | X | X | X | X | **X** |
-| 🔶 MEDIUM | X | X | X | X | X | X | **X** |
-| 🔷 LOW | X | X | X | X | X | X | **X** |
-| **合计** | **X** | **X** | **X** | **X** | **X** | **X** | **X** |
-
----
-
-## 🚨 严重问题 (CRITICAL)
-
-[如果有CRITICAL级别问题，按维度组织]
-
-### 🐛 正确性
-
-#### [问题编号]. [问题标题]
-**文件**: [文件路径]
-
-**问题描述**：[简要说明]
-
-**影响范围**：[如果影响调用方，说明影响]
-
-**详细分析**：
-- [详细分析内容]
-
-**当前代码**：
-\\\`\\\`\\\`language
-[有问题的代码]
-\\\`\\\`\\\`
-
-**建议修复**：
-\\\`\\\`\\\`language
-[修复后的代码]
-\\\`\\\`\\\`
-
----
-
-[其他维度的CRITICAL问题，格式相同]
-
----
-
-## ⚠️ 高风险问题 (HIGH)
-
-[按维度组织HIGH级别问题， 格式与CRITICAL相同]
-
----
-
-## 🔶 中等风险问题 (MEDIUM)
-
-[按维度组织MEDIUM级别问题， 格式与CRITICAL相同]
-
----
-
-## 🔷 低风险问题 (LOW)
-
-[按维度组织LOW级别问题， 格式与CRITICAL相同]
-
----
-
-## 📈 整体代码质量评估
-
-### 优点
-[列出代码的优点]
-
-### 需要改进的方面
-[列出需要改进的方面]
-\`\`\``;
-    }
-    /**
-     * 构建质量检查阶段
-     */
-    static buildQualityCheckPhase(projectRoot, options) {
-        let content = `## 第四阶段：质量检查
-
-### 步骤 6：评审结果完整性检查
-
-生成报告后，请进行以下检查：
-
-#### 1. 数量一致性检查
-- 统计表中的总问题数 = 报告中实际列出的问题数
-- 每个维度的计数 = 该维度下实际列出的问题数
-- 每个严重性级别的计数 = 该级别下实际列出的问题数
-
-#### 2. 结构完整性检查
-- 确认报告按 **严重性 > 维度** 两级结构组织
-- 确认每个问题都有完整的字段：
-  - 问题描述
-  - 影响范围（如适用）
-  - 详细分析
-  - 当前代码
-  - 建议修复
-
-#### 3. 内容完整性检查
-- 随机抽查 2-3 个问题，对比原始 subagent 输出
-- 确认代码示例、分析细节没有被简化或遗漏
-- 确认技术术语、文件路径等关键信息准确无误
-
-**如果发现问题**：
-- 如果数量不一致：重新检查 subagent 输出，补充遗漏的问题
-- 如果结构不正确：按照模板重新组织
-- 如果内容被简化：恢复完整的原始内容
-
-**检查通过后**：
-- 输出消息："✅ 评审报告已生成并通过质量检查"
-- 提供报告的关键统计信息`;
-        if (options?.notice) {
-            content += `
-
----
-
-### 步骤 7：生成完成标志文件
-
-**重要**：为了方便 CI/CD 流水线集成，请在项目根目录创建标志文件：
-
-使用 **Write** 工具创建文件 \`${projectRoot}/.review-completed\`，内容如下：
-
-\`\`\`json
-{
-  "status": "completed",
-  "timestamp": "<当前时间戳>",
-  "report": "CODE_REVIEW.md"
-}
-\`\`\`
-
-**注意**：
-- 只有在评审报告 \`CODE_REVIEW.md\` 成功创建且质量检查通过后才创建此标志文件
-- 时间戳格式：ISO 8601（例如：2025-01-15T10:30:00Z）
-- 此文件用于 CI/CD 流水线检测评审是否完成`;
-        }
-        return content;
-    }
-    /**
-     * 构建调用行动
-     */
-    static buildCallToAction() {
-        return `## 开始执行
-
-现在请按照上述流程开始执行，首先进行文件过滤分析。`;
-    }
-    /**
-     * 构建分析阶段（大型变更）
-     */
-    static buildAnalysisPhase(projectRoot, gitDiffStatCommand) {
-        return `#### 步骤 1：执行 git diff --stat
-
-请执行以下命令获取所有变更文件：
-
-\`\`\`bash
-cd ${projectRoot}
-${gitDiffStatCommand}
-\`\`\`
-
-**重要提示：不要获取完整 diff！**
-- 只需要分析 \`git diff --stat\` 的输出
-- 这将列出所有变更的文件及其变更行数
-
----
-
-#### 步骤 2：智能过滤文件（重要！）
-
-**目标**：从变更文件中识别出真正需要代码评审的文件。
-
-${this.buildFileFilteringRules()}
-
-${this.buildFileFilteringOutputFormat()}
-
-**重要**：
-- 必须列出所有变更文件，要么在"需要评审"列表，要么在"已过滤"列表
-- 每个被过滤的文件都要简要说明原因
-- 统计数据要准确
-
----
-
-#### 步骤 3：判断评审规模
-
-基于**过滤后的文件**（即"需要评审的文件"列表），判断是否需要分批：
-
-- 如果需要评审的文件 ≤ ${REVIEW_THRESHOLDS.LARGE_FILE_THRESHOLD} 个 且 变更量 ≤ ${REVIEW_THRESHOLDS.LARGE_CHANGE_THRESHOLD} 行
-  → 记录"无需分批，可以一次性评审"，跳转到阶段二（单批次评审）
-
-- 否则 → 继续步骤 4 制定分批策略
-
----
-
-#### 步骤 4：制定分批策略（如需分批）
-
-基于"需要评审的文件"列表，制定分批方案：
-
-**分批原则**：
-- 按功能模块、文件类型、业务关联性分组
-- 每批不超过 ${REVIEW_THRESHOLDS.MAX_FILES_PER_BATCH} 个文件
-- 每批不超过 ${REVIEW_THRESHOLDS.MAX_CHANGES_PER_BATCH} 行变更
-- 相关文件放在同一批（如 Service 和其对应的 Test）
-
-**输出格式**：
-
-\`\`\`markdown
-## 分批方案
-
-### 批次 1：[批次描述，如 "用户认证模块"]
-- 文件数：8 个
-- 预计变更行数：650 行
-- 文件列表：
-  - src/services/UserService.java
-  - src/services/AuthService.java
-  - src/utils/jwt.ts
-...
-
-### 批次 2：[批次描述]
-...
-
-### 批次 N：[批次描述]
-...
-\`\`\`
-
----
-
-#### 步骤 5：确认完整性
-
-检查分批方案（如果分批）或单批次方案：
-- [ ] "需要评审的文件"列表中的每个文件都已分配到某个批次
-- [ ] 没有文件被遗漏
-- [ ] 没有文件被重复分配
-
-如果检查通过，更新 TodoWrite，标记步骤1-5为完成，添加后续评审任务，继续阶段二。
-
-**重要**：此阶段只做分析和规划，不开始评审代码。`;
-    }
-    /**
-     * 构建分批评审阶段
-     */
-    static buildBatchReviewPhase(projectRoot, options) {
-        return `### 阶段二：批次评审（完成分批后执行）
-
-分批方案确定后，更新 **TodoWrite** 任务列表：
-
-\`\`\`
-1. [completed] 分析变更文件
-2. [completed] AI 智能文件过滤
-3. [completed] AI 智能制定分批次评审策略
-4. [completed] 复核分批次评审策略
-5. 评审批次 1/N
-6. 评审批次 2/N
-...
-N+6. 汇总所有批次评审结果
-N+7. 生成最终评审报告
-\`\`\`
-
-对于每个批次：
-
-1. 标记任务为 **in_progress**
-2. 使用 **Task tool** 调用 **code-reviewer** subagent
-3. **验证返回结果**：
-   - 如果返回"未发现需要关注的问题"，记录该批次无问题
-   - 如果返回了问题列表，快速检查格式是否正确
-4. 标记为 **completed**，继续下一批次
-
-**Task tool 调用示例**：
-
-\`\`\`typescript
-{
-  subagent_type: 'code-reviewer',
-  description: '代码评审 - 批次 1/N: [批次描述]',
-  prompt: \`请按照你的标准评审流程进行全面代码评审（批次 1/N）。
-
-## 批次信息
-
-- 批次描述：[描述，如 "用户认证模块"]
-- 文件数：X 个
-- 预计变更行数：Y 行
-
-## 需要评审的文件列表
-
-- file1.ts
-- file2.ts
-- file3.ts
-...
-
-## 获取变更内容
-
-请执行以下命令获取本批次的代码变更：
-
-\\\`\\\`\\\`bash
-cd ${projectRoot}
-git diff ${GitUtils.buildComparisonString(options, 'command')} -- file1.ts file2.ts file3.ts
-\\\`\\\`\\\`
-
-（将 file1.ts file2.ts file3.ts 替换为实际的批次文件列表）
-
-${this.buildEnhancedRulesSection(projectRoot, options)}
-
-## 结果检查（非常重要）
-
-在返回结果开头请注明：**批次 1/N - [批次描述]**
-
-在返回结果前，要确保：
-
-1. 已评审所有指定文件
-
-如果有遗漏、未评审的文件， 请补充评审
-
-2. 每个问题都在 diff 中明确存在
-3. 没有基于"理论上可能"的问题
-4. 没有报告已被处理/修复的问题
-5. 问题是真实存在，不是幻觉、"挑毛病"
-
-如果有误报的问题，请剔除
-
-6. 每个问题都有 [严重性][维度] 标签
-7. CRITICAL/HIGH 有：问题描述、详细分析、当前代码、建议修复
-8. MEDIUM/LOW 有：问题描述、简要说明
-9. 问题严重性符合 SEVERITY_GUIDELINES
-10. 问题维度符合 REVIEW_DIMENSIONS
-
-如果有描述不当或者信息缺失的报告问题，请调整修正
-
-**质量标准**：
-- ✅ 宁可 5 个准确问题，不要 10 个含 3 个误报
-- ✅ 准确性 > 完整性
-- ✅ 不确定时：不报告或降低严重性\`
-}
-\`\`\`
-
-**关键点**：
-- 不要在主 task 中获取完整 diff，只提供 git diff 命令
-- code-reviewer subagent 会自己执行命令并获取 diff
-- code-reviewer subagent 会自己读取所有相关文件
-- code-reviewer subagent 会自己进行深度代码评审并自检
-- code-reviewer subagent 会返回评审结果`;
-    }
-    /**
-     * 构建汇总阶段
-     */
-    static buildSummaryPhase(stats, projectRoot, options) {
-        let content = `### 阶段三：汇总报告（所有批次完成后）
-
-所有批次评审完成后，执行以下步骤生成最终报告：
-
-#### 步骤 1：收集所有评审结果
-
-1. 标记汇总任务为 **in_progress**
-2. 从所有 code-reviewer subagent 的返回结果中，**逐条提取**所有问题
-3. 每个问题保留完整信息（不修改、不删减）：
-   - 文件路径
-   - [严重性][维度] 标签
-   - 问题标题
-   - 问题描述
-   - 影响范围
-   - 详细分析
-   - 当前代码（完整上下文）
-   - 建议修复（完整代码）
-
-**关键要求**：
-- 必须收集**所有问题**，不得遗漏任何一个
-- 必须保留**所有细节**，包括代码块、修复建议等
-- 如果某个subagent返回"未发现需要关注的问题"，则该批次无问题
-- 不要对问题进行总结或简化
-
----
-
-#### 步骤 2：按维度和严重性重新组织
-
-将收集到的所有问题按照以下结构重新组织：
-
-\`\`\`
-CRITICAL 问题列表
-├── 正确性
-│   ├── 问题1（完整信息）
-│   └── 问题2（完整信息）
-├── 安全性
-│   └── 问题3（完整信息）
-└── 性能
-    └── 问题4（完整信息）
-
-HIGH 问题列表
-├── 正确性
-├── 安全性
-├── 性能
-├── 可维护性
-├── 架构设计
-└── 最佳实践
-
-MEDIUM 问题列表
-...
-
-LOW 问题列表
-...
-\`\`\`
-
-**组织要求**：
-- 第一层：按严重性分类（CRITICAL → HIGH → MEDIUM → LOW）
-- 第二层：按维度分类（正确性、安全性、性能、可维护性、架构设计、最佳实践）
-- 如果某个严重性级别下某个维度没有问题，则不显示该维度
-- 每个问题保留完整的原始信息，不进行任何删减
-
----
-
-#### 步骤 3：生成最终报告
-
-按照以下格式生成 \`CODE_REVIEW.md\`：
-
-${this.buildReportTemplate(stats)}
-
-**注意**：评审报告中不要体现批次信息，需要整体看上去是一次性完成的评审。
-
----
-
-#### 步骤 4：汇总完整性检查（必须执行！）
-
-**目的**：确保汇总过程没有遗漏 subagent 的评审结果
-
-**检查项**：
-
-1. **数量完整性**
-   - 回顾所有批次的 subagent 返回结果
-   - 统计各批次报告的问题总数：批次1(X个) + 批次2(Y个) + ... = 总计N个
-   - 统计最终报告中的问题总数：M个
-   - 验证：N = M
-   - ❌ 如果不相等，返回步骤1重新逐条收集
-
-2. **结构正确性**
-   - [ ] 按"严重性 > 维度"组织
-   - [ ] 评审摘要表格数据与实际问题数量一致
-   - [ ] 没有批次信息残留（"批次1"、"第一批"等）
-   - ❌ 如果有误，重新组织结构或重新计算
-
-3. **内容完整性**（抽查）
-   - 随机抽查2-3个问题，确认汇总时没有删减内容
-   - 对比原始 subagent 结果与最终报告中的对应问题
-   - ❌ 如果发现删减，从原始结果中恢复完整内容
-
-**所有检查项通过后**：
-1. 将最终报告写入 \`CODE_REVIEW.md\`
-2. 标记任务为 **completed**
-3. 输出简要总结：
-   \`\`\`
-   ✅ 代码评审完成
-
-   📊 评审统计：
-   - 批次数：X
-   - 原始文件数：Y
-   - 评审文件数：Z
-   - 问题总数：W (CRITICAL: a, HIGH: b, MEDIUM: c, LOW: d)
-
-   📁 报告已生成：CODE_REVIEW.md
-   \`\`\``;
-        if (options?.notice) {
-            content += `
-
----
-
-#### 步骤 5：生成完成标志文件
-
-**重要**：为了方便 CI/CD 流水线集成，请在项目根目录创建标志文件：
-
-使用 **Write** 工具创建文件 \`${projectRoot}/.review-completed\`，内容如下：
-
-\`\`\`json
-{
-  "status": "completed",
-  "timestamp": "<当前时间戳>",
-  "report": "CODE_REVIEW.md"
-}
-\`\`\`
-
-**注意**：
-- 只有在评审报告 \`CODE_REVIEW.md\` 成功创建后才创建此标志文件
-- 时间戳格式：ISO 8601（例如：2025-01-15T10:30:00Z）
-- 此文件用于 CI/CD 流水线检测评审是否完成`;
-        }
-        return content;
-    }
-    /**
-     * 构建大型变更调用行动
-     */
-    static buildLargeChangeCallToAction() {
-        return `## 立即开始
-
-**第一步**：使用 TodoWrite 创建任务列表
-
-**第二步**：执行 git diff --stat 命令获取所有变更文件
-
-**第三步**：智能过滤文件，识别需要评审的文件
-
-**第四步**：基于过滤后的文件制定分批策略（如需要）
-
-**重要**：此阶段只做分析、过滤和规划，不开始评审代码
-**重要**：此阶段后请继续执行阶段二和阶段三，不要中断，不要询问是否继续
-
-请开始执行！`;
-    }
-    // ============================================================================
-    // Commits 模式专用方法
-    // ============================================================================
-    /**
-     * 构建 commits 模式变更摘要头部
-     */
-    static buildCommitsHeader(stats, changeList) {
-        const commitsCount = this.getUniqueCommitsCount(changeList);
-        return `# 代码评审任务 - Commits 模式
-
-## 变更摘要
-
-- **Commits 数量**: ${commitsCount} 个
-- **文件总数**: ${stats.fileCount} 个
-- **新增行数**: ${stats.addedLines} 行
-- **删除行数**: ${stats.deletedLines} 行
-- **总变更量**: ${stats.totalChanges} 行
-
-变更规模适中，将使用 code-reviewer 一次性完成评审。`;
-    }
-    /**
-     * 构建 commits 模式大型变更头部
-     */
-    static buildCommitsLargeChangeHeader(stats, changeList) {
-        const commitsCount = this.getUniqueCommitsCount(changeList);
-        return `# 代码评审任务 - Commits 模式（大型变更）
-
-## 变更摘要
-
-- **Commits 数量**: ${commitsCount} 个
-- **文件总数**: ${stats.fileCount} 个
-- **新增行数**: ${stats.addedLines} 行
-- **删除行数**: ${stats.deletedLines} 行
-- **总变更量**: ${stats.totalChanges} 行
-
-由于这是一个**大型变更**（超过 ${REVIEW_THRESHOLDS.LARGE_FILE_THRESHOLD} 个文件或 ${REVIEW_THRESHOLDS.LARGE_CHANGE_THRESHOLD} 行代码），需要分批次进行评审。`;
-    }
-    /**
-     * 构建 commits 模式文件过滤阶段
-     */
-    static buildCommitsFileFilteringPhase(projectRoot, changeList) {
-        const changeListJson = JSON.stringify({ changeList }, null, 2);
-        return `## 第一阶段：AI 智能文件过滤
-
-### 步骤 1：查看变更文件列表并进行智能过滤
-
-以下是多个 commit 合并后的变更文件列表（changeList）：
-
-\`\`\`json
-${changeListJson}
-\`\`\`
-
-**说明**：
-- 如果文件只在一个 commit 中修改，则只有 \`commit\` 字段
-- 如果文件在多个 commit 中修改，则有 \`commit1\` 和 \`commit2\` 字段（分别表示第一个和最后一个修改它的 commit）
-- \`modifyLines\` 表示该文件的总变更行数
-
-**然后对变更文件进行 AI 智能过滤分析**：
-
-${this.buildFileFilteringRules()}
-
-${this.buildFileFilteringOutputFormat()}
-
-### 步骤 2：检查过滤结果
-
-**重要**：如果所有文件都被过滤掉（需要评审的文件为 0），则：
-1. 输出消息："✅ 本次变更无需代码评审（全部为文档、配置或自动生成文件）"
-2. 创建简单的 CODE_REVIEW.md 文件说明情况
-3. 结束评审流程
-
-如果还有需要评审的文件，继续下一步。`;
-    }
-    /**
-     * 构建 commits 模式代码评审阶段
-     */
-    static buildCommitsCodeReviewPhase(projectRoot, changeList, options) {
-        return `## 第二阶段：执行代码评审
-
-### 步骤 3：AI 智能代码评审
-
-使用 **Task tool** 调用 code-reviewer subagent，**仅对需要评审的文件进行评审**：
-
-\`\`\`typescript
-{
-  subagent_type: 'code-reviewer',
-  description: '代码评审 - Commits 模式',
-  prompt: \`${this.buildCommitsSubagentPrompt(projectRoot, changeList, options)}\`
-}
-\`\`\`
-
-### 步骤 4：等待评审完成
-
-subagent 会自动：
-1. 根据 changeList 为每个文件执行相应的 git diff 命令
-2. 使用 Read tool 读取相关文件（重点关注需要评审的文件）
-3. 按照六个维度进行深度代码评审
-4. 进行自我检查确保评审质量`;
-    }
-    /**
-     * 构建 commits 模式分析阶段
-     */
-    static buildCommitsAnalysisPhase(projectRoot, changeList) {
-        const changeListJson = JSON.stringify({ changeList }, null, 2);
-        return `#### 步骤 1：查看 changeList
-
-以下是多个 commit 合并后的变更文件列表（changeList）：
-
-\`\`\`json
-${changeListJson}
-\`\`\`
-
-**说明**：
-- 如果文件只在一个 commit 中修改，则只有 \`commit\` 字段
-- 如果文件在多个 commit 中修改，则有 \`commit1\` 和 \`commit2\` 字段（分别表示第一个和最后一个修改它的 commit）
-- \`modifyLines\` 表示该文件的总变更行数
-
-**重要提示：不要获取完整 diff！**
-- 只需要分析 changeList 中的文件列表和变更行数
-- 这将列出所有变更的文件及其变更行数
-
----
-
-#### 步骤 2：智能过滤文件
-
-**目标**：从变更文件中识别出真正需要代码评审的文件。
-
-${this.buildFileFilteringRules()}
-
-${this.buildFileFilteringOutputFormat()}
-
-**重要**：
-- 必须列出所有变更文件，要么在"需要评审"列表，要么在"已过滤"列表
-- 每个被过滤的文件都要简要说明原因
-- 统计数据要准确
-
----
-
-#### 步骤 3：判断评审规模
-
-基于**过滤后的文件**（即"需要评审的文件"列表），判断是否需要分批：
-
-- 如果需要评审的文件 ≤ ${REVIEW_THRESHOLDS.LARGE_FILE_THRESHOLD} 个 且 变更量 ≤ ${REVIEW_THRESHOLDS.LARGE_CHANGE_THRESHOLD} 行
-  → 记录"无需分批，可以一次性评审"，跳转到阶段二（单批次评审）
-
-- 否则 → 继续步骤 4 制定分批策略
-
----
-
-#### 步骤 4：制定分批策略（如需分批）
-
-基于"需要评审的文件"列表，制定分批方案：
-
-**分批原则**：
-- 按功能模块、文件类型、业务关联性分组
-- 每批不超过 ${REVIEW_THRESHOLDS.MAX_FILES_PER_BATCH} 个文件
-- 每批不超过 ${REVIEW_THRESHOLDS.MAX_CHANGES_PER_BATCH} 行变更
-- 相关文件放在同一批（如 Service 和其对应的 Test）
-
-**输出格式**：
-
-\`\`\`markdown
-## 分批方案
-
-### 批次 1：[批次描述，如 "用户认证模块"]
-- 文件数：8 个
-- 预计变更行数：650 行
-- 文件列表：
-  - src/services/UserService.java
-  - src/services/AuthService.java
-  - src/utils/jwt.ts
-...
-
-### 批次 2：[批次描述]
-...
-
-### 批次 N：[批次描述]
-...
-\`\`\`
-
----
-
-#### 步骤 5：确认完整性
-
-检查分批方案（如果分批）或单批次方案：
-- "需要评审的文件"列表中的每个文件都已分配到某个批次
-- 没有文件被遗漏
-- 没有文件被重复分配
-
-如果检查通过，更新 TodoWrite，标记步骤1-5为完成，添加后续评审任务，继续阶段二。
-
-**重要**：此阶段只做分析和规划，不开始评审代码。`;
-    }
-    /**
-     * 构建 commits 模式分批评审阶段
-     */
-    static buildCommitsBatchReviewPhase(projectRoot, changeList, options) {
-        return `### 阶段二：批次评审（完成分批后执行）
-
-分批方案确定后，更新 **TodoWrite** 任务列表：
-
-\`\`\`
-1. [completed] 分析变更文件
-2. [completed] AI 智能文件过滤
-3. [completed] AI 智能制定分批次评审策略
-4. [completed] 复核分批次评审策略
-5. 评审批次 1/N
-6. 评审批次 2/N
-...
-N+6. 汇总所有批次评审结果
-N+7. 生成最终评审报告
-\`\`\`
-
-对于每个批次：
-
-1. 标记任务为 **in_progress**
-2. 使用 **Task tool** 调用 **code-reviewer** subagent
-3. **验证返回结果**：
-   - 如果返回"未发现需要关注的问题"，记录该批次无问题
-   - 如果返回了问题列表，快速检查格式是否正确
-4. 标记为 **completed**，继续下一批次
-
-**Task tool 调用示例**：
-
-\`\`\`typescript
-{
-  subagent_type: 'code-reviewer',
-  description: '代码评审 - 批次 1/N: [批次描述]',
-  prompt: \`请按照你的标准评审流程进行全面代码评审（批次 1/N - Commits 模式）。
-
-## 批次信息
-
-- 批次描述：[描述，如 "用户认证模块"]
-- 文件数：X 个
-- 预计变更行数：Y 行
-
-## 需要评审的文件 changeList
-
-提供该批次文件的 changeList JSON：
-
-\\\`\\\`\\\`json
-{
-  "changeList": [
-    { "filePath": "file1.ts", "commit": "abc123", "modifyLines": 50 },
-    { "filePath": "file2.ts", "commit1": "abc123", "commit2": "def456", "modifyLines": 120 },
-    ...
-  ]
-}
-\\\`\\\`\\\`
-
-## 获取变更内容
-
-对于 changeList 中的每个文件，根据 commit 字段执行相应的 git diff 命令：
-
-- 如果文件只有 \\\`commit\\\` 字段，执行：
-  \\\`\\\`\\\`bash
-  git diff <commit>^ <commit> -- <filePath>
-  \\\`\\\`\\\`
-
-- 如果文件有 \\\`commit1\\\` 和 \\\`commit2\\\` 字段，执行：
-  \\\`\\\`\\\`bash
-  git diff <commit1>^ <commit2> -- <filePath>
-  \\\`\\\`\\\`
-
-${this.buildEnhancedRulesSection(projectRoot, options)}
-
-在返回结果开头请注明：**批次 1/N - [批次描述] (Commits 模式)**
-
-## 结果检查（非常重要）
-
-在返回结果前，要确保：
-
-1. 已评审所有指定文件
-
-如果有遗漏、未评审的文件， 请补充评审
-
-2. 每个问题都在 diff 中明确存在
-3. 没有基于"理论上可能"的问题
-4. 没有报告已被处理/修复的问题
-5. 问题是真实存在，不是幻觉、"挑毛病"
-
-如果有误报的问题，请剔除
-
-6. 每个问题都有 [严重性][维度] 标签
-7. CRITICAL/HIGH 有：问题描述、详细分析、当前代码、建议修复
-8. MEDIUM/LOW 有：问题描述、简要说明
-9. 问题严重性符合 SEVERITY_GUIDELINES
-10. 问题维度符合 REVIEW_DIMENSIONS
-
-如果有描述不当或者信息缺失的报告问题，请调整修正
-
-**质量标准**：
-- 宁可 5 个准确问题，不要 10 个含 3 个误报
-- 准确性 > 完整性
-- 不确定时：不报告\`
-}
-\`\`\`
-
-**关键点**：
-- 不要在主 task 中获取完整 diff，只提供 changeList 和 git diff 命令说明
-- code-reviewer subagent 会自己根据 changeList 执行相应的 git diff 命令
-- code-reviewer subagent 会自己读取所有相关文件
-- code-reviewer subagent 会自己进行深度代码评审并自检
-- code-reviewer subagent 会返回评审结果`;
-    }
-    /**
-     * 构建 commits 模式 subagent prompt
-     */
-    static buildCommitsSubagentPrompt(projectRoot, changeList, options) {
-        const changeListJson = JSON.stringify({ changeList }, null, 2);
-        return `请按照你的标准评审流程进行全面代码评审（Commits 模式）。
-
-## 变更信息
-
-- 需要评审的文件：X 个
-- 变更行数：约 Y 行
-
-## 需要评审的文件 changeList
-
-\\\`\\\`\\\`json
-${changeListJson}
-\\\`\\\`\\\`
-
-**说明**：
-- 如果文件只有 \\\`commit\\\` 字段，表示只在一个 commit 中修改
-- 如果文件有 \\\`commit1\\\` 和 \\\`commit2\\\` 字段，表示在多个 commit 中修改（第一个和最后一个）
-- \\\`modifyLines\\\` 表示该文件的总变更行数
-
-## 获取变更内容
-
-对于 changeList 中的每个文件，根据 commit 字段执行相应的 git diff 命令：
-
-- 如果文件只有 \\\`commit\\\` 字段，执行：
-  \\\`\\\`\\\`bash
-  git diff <commit>^ <commit> -- <filePath>
-  \\\`\\\`\\\`
-
-- 如果文件有 \\\`commit1\\\` 和 \\\`commit2\\\` 字段，执行：
-  \\\`\\\`\\\`bash
-  git diff <commit1>^ <commit2> -- <filePath>
-  \\\`\\\`\\\`
-
-（将 <commit>、<commit1>、<commit2>、<filePath> 替换为 changeList 中的实际值）
-
-${this.buildEnhancedRulesSection(projectRoot, options)}
-
-## 结果检查(非常重要)
-
-在返回结果前，要确保：
-
-1. 已评审所有指定文件
-
-如果有遗漏、未评审的文件， 请补充评审
-
-2. 每个问题都在 diff 中明确存在
-3. 没有基于"理论上可能"的问题
-4. 没有报告已被处理/修复的问题
-5. 问题是真实存在，不是幻觉、"挑毛病"
-
-如果有误报的问题，请剔除
-
-6. 每个问题都有 [严重性][维度] 标签
-7. CRITICAL/HIGH 有：问题描述、详细分析、当前代码、建议修复
-8. MEDIUM/LOW 有：问题描述、简要说明
-9. 问题严重性符合 SEVERITY_GUIDELINES
-10. 问题维度符合 REVIEW_DIMENSIONS
-
-如果有描述不当或者信息缺失的报告问题，请调整修正
-
-**质量标准**：
-- 宁可 5 个准确问题，不要 10 个含 3 个误报
-- 准确性 > 完整性
-- 不确定时：不报告或降低严重性`;
-    }
-    /**
-     * 获取 changeList 中的唯一 commit 数量
-     */
-    static getUniqueCommitsCount(changeList) {
-        const commits = new Set();
-        for (const file of changeList) {
-            if (file.commit) {
-                commits.add(file.commit);
-            }
-            if (file.commit1) {
-                commits.add(file.commit1);
-            }
-            if (file.commit2) {
-                commits.add(file.commit2);
-            }
-        }
-        return commits.size;
-    }
-}
-// ============================================================================
-// 评审策略选择器
-// ============================================================================
-/**
- * 评审策略选择器
- */
-class ReviewStrategySelector {
-    /**
-     * 根据统计信息选择评审策略
-     */
-    static selectStrategy(stats, projectRoot, options, changeList) {
-        // commits 模式单独处理
-        if (options.mode === 'commits' && changeList) {
-            return this.selectCommitsStrategy(stats, projectRoot, changeList, options);
-        }
-        // 其他模式
-        const isLargeChange = this.isLargeChange(stats);
-        if (isLargeChange) {
-            const gitDiffStatCommand = GitUtils.buildDiffStatCommand(options);
-            return ReviewPromptBuilder.buildLargeChangePrompt(stats, projectRoot, gitDiffStatCommand, options);
-        }
-        else {
-            const gitDiffCommand = GitUtils.buildDiffCommand(options);
-            return ReviewPromptBuilder.buildSmallChangePrompt(stats, projectRoot, gitDiffCommand, options);
-        }
-    }
-    /**
-     * 选择 commits 模式的评审策略
-     */
-    static selectCommitsStrategy(stats, projectRoot, changeList, options) {
-        const isLargeChange = this.isLargeChange(stats);
-        if (isLargeChange) {
-            return ReviewPromptBuilder.buildCommitsLargeChangePrompt(stats, projectRoot, changeList, options);
-        }
-        else {
-            return ReviewPromptBuilder.buildCommitsSmallChangePrompt(stats, projectRoot, changeList, options);
-        }
-    }
-    /**
-     * 判断是否为大型变更
-     */
-    static isLargeChange(stats) {
-        return stats.fileCount > REVIEW_THRESHOLDS.LARGE_FILE_THRESHOLD ||
-            stats.totalChanges > REVIEW_THRESHOLDS.LARGE_CHANGE_THRESHOLD;
-    }
-}
-// ============================================================================
-// 帮助信息构建器
-// ============================================================================
-/**
- * 构建 review 命令的帮助信息
- */
-function buildHelpMessage() {
-    return `# /review - 智能代码评审命令
-
-## 📖 功能说明
-
-执行 AI 驱动的代码评审，支持多种评审模式，自动识别变更规模并智能分批处理。
-
-## 🚀 使用方法
-
-### 基本用法
-
-\`\`\`bash
-/review                    # 评审未提交的变更（默认模式）
-/review --help            # 显示帮助信息
-/review -h                # 显示帮助信息（简写）
-\`\`\`
-
-### Commit 模式
-
-\`\`\`bash
-/review -commit <commit1>              # 评审单个 commit 的变更
-/review -commit <commit1> <commit2>    # 评审两个 commit 之间的差异
-\`\`\`
-
-**示例：**
-\`\`\`bash
-/review -commit abc1234                # 评审 commit abc1234 的变更
-/review -commit abc1234 def5678        # 评审 abc1234 到 def5678 之间的变更
-\`\`\`
-
-### Branch 模式
-
-\`\`\`bash
-/review -branch <branch1>              # 评审分支与 main 的差异
-/review -branch <branch1> <branch2>    # 评审两个分支之间的差异
-\`\`\`
-
-**示例：**
-\`\`\`bash
-/review -branch feature-login          # 评审 feature-login 分支与 main 的差异
-/review -branch dev staging            # 评审 dev 和 staging 分支之间的差异
-\`\`\`
-
-## ⚙️ 可选参数
-
-### --prompt-enhance <文件路径>
-
-指定额外的评审规则文件，补充默认的评审标准。
-
-**示例：**
-\`\`\`bash
-/review --prompt-enhance ./custom-rules.md
-/review -commit abc1234 --prompt-enhance ./team-standards.md
-\`\`\`
-
-### --notice
-
-为 CI/CD 流水线集成生成完成标志文件（\`.review-completed\`）。
-
-**示例：**
-\`\`\`bash
-/review --notice
-/review -commit abc1234 --notice
-\`\`\`
-
-**标志文件格式：**
-\`\`\`json
-{
-  "status": "completed",
-  "timestamp": "2025-01-15T10:30:00Z",
-  "report": "CODE_REVIEW.md"
-}
-\`\`\`
-
-## 📊 评审特性
-
-### 智能分批处理
-- **小型变更**（≤50 文件或 ≤3000 行）：一次性评审
-- **大型变更**（>50 文件或 >3000 行）：自动分批评审
-
-### 智能文件过滤
-自动过滤不需要评审的文件：
-- 文档文件（README.md, CHANGELOG.md）
-- 依赖锁文件（package-lock.json, yarn.lock）
-- 二进制文件和媒体文件
-- 自动生成的代码
-- IDE 配置文件
-
-### 六维度评审
-- 🐛 **正确性**：逻辑错误、边界条件、异常处理
-- 🔒 **安全性**：注入漏洞、权限控制、数据验证
-- ⚡ **性能**：算法效率、资源使用、查询优化
-- 🔧 **可维护性**：代码复杂度、命名规范、文档完整性
-- 🏗️ **架构设计**：设计模式、模块解耦、接口设计
-- ✨ **最佳实践**：代码风格、惯用法、工程规范
-
-### 四级严重性
-- 🚨 **CRITICAL**：必须立即修复的致命问题
-- ⚠️ **HIGH**：重要问题，应尽快修复
-- 🔶 **MEDIUM**：中等问题，建议修复
-- 🔷 **LOW**：轻微问题，可选择性修复
-
-## 📝 输出结果
-
-评审完成后会生成 \`CODE_REVIEW.md\` 报告，包含：
-- 变更概览和统计信息
-- 按严重性和维度分类的问题列表
-- 详细的问题分析和修复建议
-- 代码质量整体评估
-
-## 💡 使用技巧
-
-1. **首次使用**：建议先对小范围变更进行评审，熟悉评审流程
-2. **自定义规则**：使用 \`--prompt-enhance\` 添加团队特定的编码规范
-3. **CI/CD 集成**：使用 \`--notice\` 参数在流水线中检测评审完成
-4. **大型变更**：系统会自动分批处理，无需手动干预
-
-## 🔗 相关命令
-
-- \`/help\` - 查看所有可用命令
-- \`/docs\` - 查看完整文档
-
-## ❓ 常见问题
-
-**Q: 如何只评审特定文件？**
-A: 目前评审基于 git diff 结果，可以先 stage 特定文件再评审。
-
-**Q: 评审需要多长时间？**
-A: 取决于变更规模，小型变更通常 1-3 分钟，大型变更可能需要 5-15 分钟。
-
-**Q: 如何自定义评审规则？**
-A: 创建 Markdown 文件描述你的规则，然后使用 \`--prompt-enhance\` 参数指定。
-
----
-
-💡 提示：使用 \`/review --help\` 随时查看本帮助信息`;
-}
-// ============================================================================
-// 命令导出
-// ============================================================================
-export const reviewCommand = {
-    name: 'review',
-    description: 'Performs code review with multiple modes: default (uncommitted changes), commit comparison, branch comparison, or multiple commits comparison.',
-    kind: CommandKind.BUILT_IN,
-    action: async (context, args) => {
-        // 检查是否请求帮助信息
-        const trimmedArgs = args.trim();
-        if (trimmedArgs === '--help' || trimmedArgs === '-h' || trimmedArgs === 'help') {
-            return {
-                type: 'message',
-                messageType: 'info',
-                content: buildHelpMessage(),
-            };
-        }
-        // 验证服务可用性
-        if (!context.services.config) {
-            return {
-                type: 'message',
-                messageType: 'error',
-                content: 'Configuration not available.',
-            };
-        }
-        if (!context.services.git) {
-            return {
-                type: 'message',
-                messageType: 'error',
-                content: 'Git service not available. This command requires a git repository.',
-            };
-        }
-        const projectRoot = context.services.config.getProjectRoot();
-        if (!projectRoot) {
-            return {
-                type: 'message',
-                messageType: 'error',
-                content: 'Project root not available.',
-            };
-        }
-        try {
-            // 解析参数
-            const options = ReviewArgumentParser.parse(args);
-            let stats;
-            let changeList;
-            // 根据模式获取统计信息
-            if (options.mode === 'commits' && options.commits) {
-                // commits 模式：使用 MultiCommitAnalyzer
-                const result = await MultiCommitAnalyzer.analyzeCommits(projectRoot, options.commits);
-                stats = result.stats;
-                changeList = result.changeList;
-            }
-            else {
-                // 其他模式：使用 GitStatsAnalyzer
-                stats = await GitStatsAnalyzer.getDiffStats(projectRoot, options);
-            }
-            // 检查是否有变更
-            if (stats.fileCount === 0) {
-                return {
-                    type: 'message',
-                    messageType: 'info',
-                    content: 'No differences found to review.',
-                };
-            }
-            // 根据变更规模选择评审策略
-            const reviewPrompt = ReviewStrategySelector.selectStrategy(stats, projectRoot, options, changeList);
-            return {
-                type: 'submit_prompt',
-                content: reviewPrompt,
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof ReviewCommandError
-                ? error.message
-                : `Error during review: ${error instanceof Error ? error.message : String(error)}`;
-            return {
-                type: 'message',
-                messageType: 'error',
-                content: errorMessage,
-            };
-        }
-    },
-};
-//# sourceMappingURL=reviewCommand.js.map