ac-review（Review - 审查归档 + 整改计划生成）由 Claude 在当前会话内完成代码审查。
用途
用于对代码变更进行结构化审查，并在用户确认整改范围后生成整改实施计划。无参数时自动审查当前 git 变更，也可传入 git revision 审查指定提交，或审查指定的代码与描述。
使用方法
/ac-review [代码｜描述｜git修订号]
- 无参数：自动审查 git diff HEAD
- 参数为 git 修订号：审查该次提交的修改
- 其他参数：审查指定代码或描述
角色分工
- Claude（主线程）：获取待审查内容、拆分子任务、汇总结果、写入 .claude/review/.md、询问整改范围、生成 .claude/plan/review-.md、输出最终提示
- subagents：并行检索上下文、执行分项审查、返回问题列表
执行约束
工作目录 {{WORKDIR}} 使用当前工作目录的绝对路径作为审查根目录。若用户通过 /add-dir 添加多个工作区，先用 Glob/Grep 确定任务相关的工作区；无法确定时用 AskUserQuestion 询问用户选择目标工作区。
审查必须由 Claude 主线程发起，并使用 Agent 工具启动 subagents 执行子任务。多个独立子任务可并行时，必须在同一轮并行启动多个 subagents。已委托给 subagents 的搜索、阅读或审查内容，主线程不要重复执行。subagents 只做检索与审查，不做代码修改，不直接向用户输出最终结论。所有审查意见由主线程统一去重、分级并整理为审查报告。审查阶段不修改产品代码，唯一允许的写操作是生成 .claude/review/.md 与 .claude/plan/review-.md Markdown 文件。必须先生成审查报告，再询问用户整改范围；未经用户确认，不得直接生成执行计划。
执行工作流
阶段 1：获取待审查代码（研究模式）。无参数时执行 git diff HEAD 和 git status --short；参数为 git 修订号时执行 git show --stat --patch <revision> 获取该次提交的修改；其他参数时使用指定的代码/描述。调用 {{MCP_SEARCH_TOOL}} 获取相关上下文。
阶段 2：拆分审查子任务（规划模式）。主线程先基于变更范围拆分子任务，再并行发起 subagents。默认至少拆成两个方向：正确性与回归风险审查（检查逻辑错误、边界条件、空值/异常路径、潜在回归），以及可维护性与集成风险审查（检查命名与职责、重复逻辑、测试缺口、跨模块/接口一致性）。变更范围较大时，可继续按文件组、模块或专题新增子任务，但必须保持可并行、职责清晰、结果可汇总。
阶段 3：并行执行 subagents 审查（审查模式）。使用 Agent 工具在同一轮并行启动多个 subagents，每个 subagent 只负责自己的审查范围。每个 subagent 输出：问题级别（Critical / Major / Minor / Suggestion）、具体位置（file_path:line_number）、问题描述与原因，必要时给出修复建议。主线程等待所有 subagents 返回后才能进入下一阶段。
阶段 4：主线程综合反馈并归档审查结果（综合模式）。收集所有 subagents 审查结果，合并重复问题并保留最具体的证据与定位，按严重程度分类 Critical / Major / Minor / Suggestion，给出总体评价（是否可合并、主要风险点、建议优先级），生成并写入 .claude/review/<功能名>.md 审查报告，内容为 Markdown。阶段 4 结束时：创建并写入报告；向用户展示完整审查报告内容（直接输出报告 Markdown 正文）；以加粗文本输出提示，告知报告保存位置并请用户确认整改范围（可按问题级别或具体条目选择）；然后立即终止当前回复。禁止只打印结果不落盘、只提示已写入不展示正文、未经确认直接生成执行计划、直接修改产品代码、自动调用 /ac-execute 或任何实施动作。
整改范围确认后
阶段 5：生成整改实施计划（计划模式）。仅基于用户确认要修改的问题范围生成计划；对用户明确排除的问题，不纳入实施步骤，只在“暂不处理项”中记录。生成并写入 .claude/plan/review-<功能名>.md，内容为 Markdown。阶段 5 结束时：创建并写入文件、向用户展示完整实施计划、以加粗文本输出提示（包含实际文件路径），告知用户可修改计划或复制命令到新会话执行 /ac-execute，然后立即终止当前回复。
结果保存
- 审查报告：.claude/review/<功能名>.md
- 实施计划：.claude/plan/review-<功能名>.md
- 迭代版本：.claude/review/<功能名>-v2.md、.claude/plan/review-<功能名>-v2.md 等
写入应在向用户展示对应内容前完成。
结果修改流程
修改审查报告：根据用户反馈调整内容，更新 .claude/review/<功能名>.md，重新展示修改后的审查报告，再次提示用户确认整改范围。
修改实施计划：根据用户反馈调整内容，更新 .claude/plan/review-<功能名>.md，重新展示修改后的实施计划，再次提示用户审查或执行。
后续步骤
用户先审查 review 报告、确认整改范围，并在后续审查实施计划满意后，手动执行：
/ac-execute .claude/plan/review-<功能名>.md
关键规则
- 无参数 = 审查 git diff，自动获取当前变更
- git revision = 审查该次提交，自动获取指定提交的 patch 内容
- Claude 主线程统筹 + subagents 并行审查，不调用外部审查模型
- 先归档审查报告，再生成实施计划，两类产物职责必须分离
- 整改范围必须由用户确认，未确认前不得生成 .claude/plan/review-*.md
- 审查流程只读，审查阶段不修改产品代码
限制
资料未提供具体支持的模型版本、平台范围、性能指标、收费或价格信息，暂未提供。