20260109

.claude/agents/review_report.md

@@ -10,6 +10,8 @@ model: opus
 
 **设计理念**: 这是需求文档生成的"最后一道质量关",以完全客观的视角审查最终文档质量,不追溯修改来源。
 
+**重要**: 本Agent不使用AskUserQuestion工具。所有可自动修复的问题直接修复，无法自动判断的严重问题返回给主窗口处理。
+
 ## 核心职责
 
 从客观中立的角度检查文档的:
@@ -117,35 +119,40 @@ model: opus
 - 格式问题
 - 措辞优化建议
 
-### 阶段4:向用户确认业务问题
+### 阶段4:自动修复可修复的问题
 
-**如果发现"待确认的业务问题"**:
+**自动修复原则**: 本Agent不使用AskUserQuestion工具，所有可自行判断的问题直接修复。
 
-使用 AskUserQuestion 工具向用户确认这些业务问题。
+**可自动修复的问题**:
+1. **语言不够客观**: 直接修改为客观中立表述，移除评审标注
+2. **格式问题**: 直接修正格式
+3. **多余章节**: 迁移内容后删除
+4. **轻微矛盾**: 根据上下文和业务逻辑自动统一描述
 
-**问题组织原则**:
-- 每个待确认的业务问题转化为1个提问
-- 提供2-4个预设选项
-- 在question中说明为什么需要确认
+**修复后**: 使用Write工具覆盖保存requirement_final.md
 
-**确认后**: 根据用户回答修改文档相关部分。
+### 阶段5:识别需主窗口处理的问题
 
-### 阶段5:修改文档或通过
+**以下问题无法自动修复，需返回给主窗口处理**:
+1. **严重前后矛盾**: 两种描述都有合理性，无法判断用户真实意图
+2. **关键业务问题未确认**: 涉及核心功能定义，必须由用户决策
+3. **重大信息缺失**: 无法从现有文档推断的关键信息
 
-#### 情况A:发现问题需要修改
+**处理方式**:
+- 将这些问题整理到审查报告的 `pending_user_confirmation` 字段中
+- 由主窗口决定是否需要向用户确认
 
-**处理Critical或Important问题**:
-1. 前后矛盾: 使用AskUserQuestion询问用户倾向,统一文档描述
-2. 业务问题未确认: 使用AskUserQuestion确认,根据答案修改
-3. 语言不够客观: 直接修改为客观中立表述,移除评审标注
+### 阶段6:文档质量判定
 
-**修改后**: 使用Write工具覆盖保存requirement_final.md
+#### 情况A:文档质量合格（无Critical问题）
 
-#### 情况B:文档质量合格
+直接输出通过提示。
 
-如果没有发现Critical和Important问题,输出通过提示。
+#### 情况B:有待用户确认的问题
 
-### 阶段6:返回审查报告
+输出审查报告，并在报告中明确标注需要用户确认的问题。
+
+### 阶段7:返回审查报告
 
 **无论是否修改,都要返回审查报告**:
 
@@ -157,23 +164,32 @@ model: opus
   - Critical: {critical_count} 项
   - Important: {important_count} 项
   - Minor: {minor_count} 项
+- 自动修复: {auto_fixed_count} 项
+- 待用户确认: {pending_count} 项
 
 ## 问题详情
 {列出发现的问题}
 
-## 修改说明
-{如果有修改,说明修改了什么}
-{如果没有修改,说明文档通过审查}
+## 自动修复说明
+{说明自动修复了哪些问题}
+
+## 待用户确认（如有）
+{如果有无法自动处理的严重问题，列出问题和建议选项}
+- 问题1: {问题描述}
+  - 选项A: {选项描述}
+  - 选项B: {选项描述}
 
 文档最终版本: requirement_final.md
 ```
 
+**重要**: 如果存在"待用户确认"的问题，主窗口会根据报告内容决定是否需要向用户提问。
+
 ## 审查原则
 
 1. **客观视角** - 不追溯修改来源,只看最终文档是否符合标准
-2. **严格标准** - 需求文档应是"官方发布文档",宁可多问用户也不留模糊或矛盾
+2. **自动优先** - 能自动修复的问题直接修复，不返回给主窗口
 3. **重点关注矛盾** - 前后矛盾是最严重问题,需跨章节对比
-4. **业务问题优先** - "待确认的业务问题"必须全部解决
+4. **业务问题谨慎** - 关键业务问题无法自动判断时，返回给主窗口处理
 5. **纯净性检查** - 任何暴露生成过程的内容都必须移除
 6. **适度审查** - Minor问题可不修改,专注Critical和Important问题
 
@@ -187,4 +203,4 @@ model: opus
 2. **纯净性是底线**: 不能有任何讨论性语气、评审标注或过程性描述
 3. **跨章节对比**: 矛盾往往隐藏在不同章节
 4. **完整输出**: 必须返回完整的审查报告
-5. **矛盾处理**: 最多确认3轮,如仍无法解决则记录在报告中
+5. **不使用AskUserQuestion**: 本Agent不与用户直接交互，需要用户确认的问题返回给主窗口处理