ai-req2testcase-generator V4.2.0

版本:4.0.0 架构:orchestrator代码硬控 + Agent只填内容 + 6段确认模式 + HMAC签名防伪造 + P2/P5/P7代码路径 + P6双层硬门禁+prompt瘦身

🔴 运行协议

核心原则:orchestrator.py控制流程,Agent只负责执行prompt返回JSON。

参数自动化:orchestrator自动发现skill_dir、自动回填data_dir/task_id,Agent几乎不需要传参。

6段确认模式:流程分6段执行,P2/P5为自动执行步骤(无需用户确认),用户实际只需回复5次「继续」。用户始终知道流程在哪一步。

🔴🔴🔴 段落编号严格对应(绝对禁止合并段落):

段落1 = init+onboarding
段落2 = step0+图片理解
段落3 = P0+P1 + 自动P2(P2代码自动生成,无需用户确认)
段落4 = P3+P4(风险+PCI)+ 自动P5(代码自动合并,无需用户确认)
段落5 = P6(用例生成,必须用分批流程p6_batch_info→p6_save_batch→p6_merge,step_run会被拒绝)
段落6 = P7(代码自动校验)+Excel

每段结束时必须输出状态提示行,不允许把多个段落合并成一个。

🔴 操作约束矩阵(最高优先级)

| Step | Agent角色 | 唯一正确命令 | |------|----------|------------| | P0 | 执行者 | prep_prompt → 生成JSON → step_run | | P1 | 执行者 | prep_prompt → 生成JSON → step_run | | P2 | 观察者 | python3 "$ORCH" --action p2_code_generate | | P3 | 执行者 | prep_prompt → 生成JSON → step_run | | P4 | 执行者 | prep_prompt → 生成JSON → step_run | | P5 | 观察者 | python3 "$ORCH" --action p5_code_merge | | P6 | 执行者 | p6_batch_info → 循环(prep_prompt+p6_save_batch) → p6_merge | | P7 | 观察者 | python3 "$ORCH" --action p7_code_check |

观察者步骤:Agent只执行一条命令等待结果。不调用prep_prompt,不生成JSON,不写agent_output文件。 执行者步骤:Agent读取prompt,用推理能力生成高质量JSON,写入文件,调用orchestrator校验。

Agent在本技能中只做3类事情:

调用orchestrator命令(exec)
读取prompt文件并生成JSON结果,write到文件
读取图片并描述内容(PX步骤)

禁止Agent自行:

决定下一步做什么(由orchestrator决定)
直接写入p*_output.json文件(由orchestrator通过truncation_guard写入)
绕过orchestrator(🔴 即使orchestrator报错,也不允许回退到"手动执行"模式,必须修复参数后重试)
输出JSON结构体到对话(只写文件)

🔴🔴🔴 V3.5.2 绝对禁止行为(代码层硬控,违反即判定流程无效)

禁止直接写gate文件 - 所有 gates/*.pass.json 只能由orchestrator action内部创建,Agent不得以任何方式创建/修改gate文件
禁止直接写output文件 - 所有 p{N}_output.json 只能通过 step_run/p2_code_generate/p5_code_merge 等action写入,Agent不得直接write
禁止直接修改state文件 - orchestrator_state.json 只能由orchestrator内部修改
禁止import orchestrator - 不允许 import orchestrator、from orchestrator import、exec(open("orchestrator.py"))
禁止跳过orchestrator执行 - 所有步骤必须通过 python3 "$ORCH" --action XXX 执行,不得用Python脚本直接调用内部函数
禁止伪造执行结果 - 当orchestrator返回错误时,必须修复参数重试,不得"手动生成"替代结果
Onboarding必须逐步交互 - 4步必须逐步展示,禁止合并为1次交互

违反以上任何规则的执行结果将被代码层检测并拒绝导出。step7_export会审计全链路gate来源,非法来源的gate将被拒绝。

对话输出规则:每段只输出1行状态+确认提示。

触发条件

「ai用例生成」「ai需求分析」「ai测试用例」「ai测试用例生成」「req2testcase」「生成测试用例」「分析需求」「拆解功能点」「输出测试点」「需求评审」「帮我写用例」「这个需求怎么测」「PRD转测试用例」

🔴 6段确认模式

需求载荷前置: 触发后,如用户消息中不包含需求正文/需求附件/明确引用近期需求材料,仅输出:请发送需求正文或需求文档,收到后立即开始分析。

收到需求后,按以下6段执行(P2/P5自动执行,用户只需回复5次「继续」):

📋 段落1:初始化 + Onboarding

首先定位orchestrator(只需执行一次,后续复用$ORCH变量):

exec: ORCH=$(find ~/.openclaw ~/.local ~/skills /app/skills -name orchestrator.py -path "*/ai-req2testcase-generator/*" -print -quit 2>/dev/null) && echo "ORCH=$ORCH"

如果找到,后续所有命令使用 python3 "$ORCH" 调用。如果未找到,输出错误。

exec: python3 "$ORCH" --action init
→ 获得 task_id

exec: python3 "$ORCH" --action onboarding
→ 环境检查结果(返回next_action字段,必须遵循)

🔴🔴🔴 onboarding返回后,段落1还没完成!必须继续执行以下4步交互,每步等用户回复后才展示下一步:

🔴 第1步:PRD审查(必须单独展示,等用户回复)

📋 PRD审查可在生成用例前检查需求文档质量。
请选择:
• 回复「开启」→ 启动PRD审查(不到合格分会中断并输出问题清单)
• 回复「跳过」→ 直接生成用例

用户回复后执行: exec: python3 "$ORCH" --action set_prd_review --enabled {true或false} (用户选"开启"→ --enabled true,选"跳过"→ --enabled false) 🔴 必须等用户回复后,才能展示第2步。不允许和其他选项一起展示。

🔴 第2步:L5知识库(等第1步用户回复后才展示)

📚 L5知识库可注入历史测试经验,提升用例质量。
请选择:
• 上传知识库文件 → 解析入库
• 回复「跳过」→ 不使用知识库

🔴 必须等用户回复后,才能展示第3步。

🔴 第3步:P6用例生成模式(等第2步用户回复后才展示)

🧪 P6用例生成模式选择
请选择:
• 回复「1」→ turbo模式(强模型直出,推荐deepseek-v4/claude-sonnet-4/gpt-4o)
• 回复「2」→ hybrid模式(代码生成+Agent润色,推荐minimax/qwen等一般模型)
• 回复「3」→ strict模式(严格门禁+自动重试,任何模型均可)

用户回复后,Agent执行: exec: python3 "$ORCH" --action set_p6_mode --mode {用户选择的模式名} 🔴 必须等用户回复后,才能展示第4步。

🔴 第4步:图片理解API密码(等第3步用户回复后才展示) (见下方检查4B详细流程)

检查4B:图片理解 + 评审工具密码

i️ 图片理解API可自动解析需求文档中的原型图/流程图/截图,提升用例质量。
🔗 评审工具可将生成的用例推送到在线评审平台,支持可视化评审与经验闭环。

请输入密码(图片API + 评审工具共用同一密码):
• 回复密码 → 同时启用图片理解 + 在线评审推送(密码验证后启用,不会保存到任何文件)
• 回复「跳过」→ 纯文本模式,图片信息仅通过前后文推断,不推送评审工具

用户输入密码时:

Agent将密码传给orchestrator进行验证:exec: python3 "$ORCH" --action check_image_api --api-key "用户输入的密码"
orchestrator调用API的/api/auth-check接口验证密码
密码正确→启用,Agent记住密码(仅在当前会话,不写文件),后续step0_8_prep时传入
密码错误→提示用户"密码验证失败",允许重试(最多3次),3次失败后自动降级为纯文本模式
服务不可用→提示"API服务暂不可用",自动降级为纯文本模式

密码验证失败时的处理流程:

第1次失败:提示"密码错误,请重新输入或回复「跳过」"
第2次失败:提示"密码再次错误,还有1次机会,或回复「跳过」"
第3次失败:自动切换为纯文本模式,告知用户

用户选择「跳过」→纯文本降级模式(caption_only)

⚠️ 密码安全:不写入任何文件,不保存到preferences/environment,仅在当前会话内存中持有

完成后输出:

✅ 段落1完成 | Onboarding通过 | task_id=xxx
📋 请回复「继续」开始需求分析

📋 段落2:需求接收 + 图片理解

用户回复"继续"/"好的"/"下一步"/"go"等确认意图后执行:

🔴 段间验证(必须先执行):

exec: python3 "$ORCH" --action status

确认onboarding gate pass存在。如不存在,必须重新执行段落1。

exec: python3 "$ORCH" --action step0 --requirement-file "{docx_path}"
→ 需求接收完成

exec: python3 "$ORCH" --action step0_8_prep --requirement-file "{docx_path}" --api-key "{用户在Onboarding中输入的密码}"
→ V3.2.5: orchestrator自动调用API理解图片(密码正确时),或降级为caption_only
→ 密码为空或未输入则自动降级
→ 结果写入px_api_results.json,无需Agent看图
→ 如返回skipped:非docx或无图片,跳过

exec: python3 "$ORCH" --action step0_8_save
→ 统一收口:读取结果→px_understand.json→image_enhance→mark_complete

完成后输出:

✅ 段落2完成 | 需求已解析 | 业务域:xxx | 图片N张
📋 请回复「继续」开始需求结构化

📋 段落3:需求结构化 + 模块拆解 + 自动测试点(P0 + P1 + 自动P2)

用户确认后执行:

🔴 段间验证(必须先执行):

exec: python3 "$ORCH" --action status

确认P0的gate pass存在(说明段落2+段落3的前置已完成)。如不存在,必须重新执行段落2。

对 P0 和 P1 各执行:
  exec: python3 "$ORCH" --action prep_prompt --step P{N}
  → 获得 prompt_file 路径
  read {prompt_file} → 用推理能力生成JSON
  write {DATA_DIR}/p{n}_agent_output.json → JSON结果
  exec: python3 "$ORCH" --action step_run --step P{N}
  → orchestrator校验+truncation_guard+gate pass

V3.5.4: P0执行完成后追加quality_check(PRD审查增强):

🔴🔴🔴 重要:如果用户开启了PRD审查,P0的JSON输出必须包含 blocks_markdown 和 issues 两个字段!
这是代码层硬校验,缺少任何一个字段,step_run将直接返回 prd_review_validation_failed 错误并拒绝。

当 prd_quality_review=True 时,P0的JSON输出必须包含:
  - blocks_markdown: string  ← 需求结构化Markdown,必须输出,不得省略
  - issues: array            ← 问题清单数组,无问题时输出空数组[]

P0的step_run成功后,立即执行:
  exec: python3 "$ORCH" --action quality_check --step P0
  → 如果返回中包含 prd_review_enabled: true,则必须展示以下内容:

  📋 **需求结构化结果**
  {blocks_markdown内容,原样输出,保持Markdown格式}

  **展示示例**(供Agent参考,实际输出以blocks_markdown内容为准):

模块1:月亮晒榜单优化(PC端)

F01 有效机构户排名优化

输入/输出

输入:机构户数据、统计周期(月度) ✅
输出:排名列表(增量排名替代原排名) ✅

业务规则

增量排名 = 本期新增机构户数排序 ✅
⚠️ 未明确增量排名排序规则(降序?平局如何处理?)

约束条件

统计周期:自然月 ✅
⚠️ 未定义"有效机构户"的判定标准

场景

正常展示、无新增机构户、多机构并列

F02 重点机构业务优化

输入/输出

输入:重点机构业务数据 ✅
输出:删除"目标完成率(%)"列 ✅

业务规则

删除操作:前端隐藏该列 ✅
⚠️ 未说明存量数据是否保留(物理删除 or 逻辑隐藏)

状态流转

删除前 → 确认提示 → 删除后刷新列表 ✅

F05-F07 福建区域新增三张表

输入/输出

输入:金种子/商机沙盘/海交综服数据 ✅
输出:三张新增tab,各含11个统计字段 ✅

业务规则

11个统计字段:⚠️ 未定义字段名称、计算公式、数据来源

约束条件

数值字段:⚠️ 未定义数据类型(整数/小数)、单位、精度
必填项:⚠️ 未明确哪些字段必填

角色权限

福建区域用户可见 ✅
⚠️ 其他区域用户是否可见未说明


⚠️ **问题清单**(共{prd_issues数量}项)
| 严重度 | 位置 | 类型 | 问题 | 建议 |
|--------|------|------|------|------|
{遍历prd_issues数组渲染表格}

📊 **质量评分:{quality_score}**

→ 如果 quality_check 返回中包含 prd_review_report_path 字段:
  发送文件: 📄 PRD审查报告已生成,点击下载:{prd_review_report_path}
  (使用相对路径或绝对路径均可,确保用户可点击下载)

→ 如果 quality_check 返回 quality_failed(评分<0.5):
  输出: ❌ 需求质量不合格,流程中断。请根据问题清单修改需求后重新提交。
  停止执行(不继续P1)
→ 如果 quality_check 返回 ok:
  展示内容后自动继续P1,不等待用户
→ 如果返回中不包含 prd_review_enabled(用户跳过了PRD审查):
  跳过展示,直接继续P1

完成后输出:

✅ 段落3完成 | P0评分:0.xx | P1模块:N个/功能点:M个

→ 生成需求理解与功能点拆解报告:
  exec: python3 "$ORCH" --action export_p0p1
  → 生成 {data_dir}/p0p1_report.md 文件

→ 发送文件给用户:
  📄 需求理解与功能点拆解报告已生成
  MEDIA:{data_dir}/p0p1_report.md
  (使用绝对路径,确保飞书可以上传文件)

→ 如果开启了PRD审查,检查data目录是否有 prd_review_report.md 文件:
  如果存在,同样发送: 📄 PRD审查报告
  MEDIA:{data_dir}/prd_review_report.md

→ **V4.0.0 评审推送闭环:**
  从export_p0p1返回的JSON中解析cloud_review字段(从exec的stdout解析JSON):
  - `cloud_review.pushed == True` → 输出: 🔗 需求理解已推送到评审工具: {cloud_review.review_url}
  - `cloud_review.pushed == False` → 输出: ⚠️ 需求推送失败({cloud_review.message}),不影响后续流程
  - 无cloud_review字段 → 跳过（未配置云端评审）

⚡ P0+P1完成后立即自动执行P2（无需用户确认）：

段落3的P0+P1完成后,Agent立即自动执行P2,不等待用户回复:

段间验证: exec: python3 "$ORCH" --action status(确认P0+P1 gate pass存在)

P2由代码自动生成,Agent执行以下命令即可:

exec: python3 "$ORCH" --action p2_code_generate

→ 代码自动读P1 feature_tree → 规则引擎生成测试点 → gate pass

段落3+4合并输出(P2自动完成后展示):

[自动] P1完成 | 功能点:N个 | 场景:M个
[自动] P2测试点生成完成 | 测试点:X条(自动生成)
📋 请回复「继续」进入风险识别(P3+P4)

V4.1.1: 当 prd_quality_review=False 时,P0完成后仍必须展示结构化结果:

exec: python3 "$ORCH" --action quality_check --step P0

→ 读取 p0_output.json,依次展示:

📋 需求结构化结果

需求目标: {objective字段,空时显示"未提供"}
质量评分: {quality_score字段} (阈值≥0.7为合格)
业务对象({blocks.business_objects长度}条): {遍历blocks.business_objects输出"- {name}",超过3条显示"...等N条"}
核心操作({blocks.operations长度}条): {遍历blocks.operations输出"- {name}",超过3条显示"...等N条"}
业务规则({blocks.business_rules长度}条): {遍历blocks.business_rules输出"- {description}"}
测试关注点({blocks.test_point_candidates长度}条): {遍历blocks.test_point_candidates输出"- {description}[{category}]"}

→ 如果 blocks 字段不存在或为空: 仅展示objective+quality_score+"⚠️ 部分结构化数据不可用" → 如果 objective 为空: 显示"⚠️ 需求目标未提取"

📋 待确认问题: → 如果 blocks 不存在或 blocks.unknowns 为空: 显示"✅ 无待确认问题" → 否则读取 blocks.unknowns(数组,每项含description和impact字段,无clarification_questions字段): 🚨 阻塞问题({blocks.unknowns中blocking=true的数量}条): {遍历blocks.unknowns中blocking=true的项,每条输出"- 🚨 {description} (影响:{impact})"} ⚠️ 非阻塞问题({blocks.unknowns中blocking=false的数量}条): {遍历blocks.unknowns中blocking=false的项,每条输出"- ⚠️ {description} (影响:{impact})"} 如果两处均为空: "✅ 无需确认问题,可继续推进"

注: 🚨阻塞=阻止开发/测试继续; ⚠️非阻塞=不影响主流程但需关注

📋 段落4:风险识别 + PCI(P3 + P4) + 自动P5合并

用户确认后执行:

🔴 段间验证:

exec: python3 "$ORCH" --action status

确认P2的gate pass存在。

⚡ P3和P4互不依赖,必须并行执行(同时进行,省3-4分钟):

并行分支1 - 执行P3(风险识别):

exec: python3 "$ORCH" --action prep_prompt --step P3

→ 读取P3 prompt → 生成JSON → write到p3_agent_output.json

exec: python3 "$ORCH" --action step_run --step P3

并行分支2 - 执行P4(PCI识别):

exec: python3 "$ORCH" --action prep_prompt --step P4

→ 读取P4 prompt → 生成JSON → write到p4_agent_output.json

exec: python3 "$ORCH" --action step_run --step P4

❗ 并行要求:P3和P4的4条命令(2条prep_prompt + 2条step_run)必须同时发起,不等其中一个完成再执行另一个。若任一步骤失败,立即停止,不执行P5合并。

⚡ V4.1.1 并行失败处理机制:

也可使用一条命令执行P3+P4并行(推荐,内置完整失败处理):

exec: python3 "$ORCH" --action p3_p4_parallel

失败处理规则:

任一失败→立即停止: P3或P4任一步骤失败,另一个立即标记为"跳过",不进入P5合并
失败日志聚合: 输出包含失败步骤名、失败阶段(prep_prompt/step_run/timeout)、失败原因、耗时
资源自动释放: 无论成功失败,finally块自动清理所有.tmp.json临时文件
重试指引: 失败时输出restart_from P3重试命令

失败时输出示例:

{"status":"failed","failure_log":[{"step":"P3","status":"failed","reason":"..."}],"can_proceed_to_p5":false}

⚡ P3+P4完成后自动执行P5合并(无需用户确认):

🔴 段间验证:

exec: python3 "$ORCH" --action status

确认P2/P3/P4的gate pass存在。

🔴🔴🔴 P5由代码自动合并,Agent绝对不参与!

Agent不生成P5 JSON,不写p5_agent_output.json
Agent不调用step_run --step P5(代码层会直接拒绝)
Agent只执行下面这一条命令,然后等结果:

exec: python3 "$ORCH" --action p5_code_merge

→ orchestrator自动读P2+P3+P4→代码合并→写入P5→gate pass

❌ 以下操作全部禁止(代码层硬控,会被拒绝):

# 禁止!会被orchestrator直接拒绝
exec: python3 "$ORCH" --action step_run --step P5
# 禁止!Agent不能自己写P5
write: p5_agent_output.json
write: p5_output.json
# 禁止!Agent不能用Python脚本生成P5
exec: python3 -c "..."
# 禁止!Agent不能伪造gate pass(V3.2.6 HMAC验签会拒绝)
write: gates/P5.pass.json

段落5+6合并输出(P5自动完成后展示):

[自动] P3+P4完成 | 风险:Y条 | PCI:Z条
[自动] P5测试点合并完成(代码自动执行)
📋 请回复「继续」进入用例生成

📋 段落5:用例生成(P6)

用户确认后执行:

🔴 段间验证:

exec: python3 "$ORCH" --action status

确认P5的gate pass存在。

📋 安全用例条件注入(V4.1.1): 需求涉及文件上传/导入时,orchestrator自动注入52行安全规则。

检测关键词:上传,导入,批量,文件,Excel,CSV,附件,docx,xlsx,上传文件,批量导入
未检测到:显示[自动] 安全用例规则跳过(未检测到文件上传场景)而非删除规则,Agent无需干预。

根据Onboarding选择的p6_mode执行对应流程:

如果p6_mode = turbo(强模型直出):

🔴 严禁:turbo模式下调用 p6_code_generate,该命令仅限hybrid模式,调用即报错退出(mode_blocked)。 🔴 严禁:以"耗时长"为由跳过分批流程或切换模式,必须逐批执行prep_prompt→p6_save_batch。

exec: python3 "$ORCH" --action p6_batch_info

→ 获得total_batches

对每个批次N=1,2,...执行:

exec: python3 "$ORCH" --action prep_prompt --step P6 --batch-index {N}

→ 读取prompt → Agent生成JSON → write到p6_batch_{N:03d}_agent_output.json

exec: python3 "$ORCH" --action p6_save_batch --batch-index {N}

→ 宽松校验(只检格式,不检内容质量)

全部批次完成后:

exec: python3 "$ORCH" --action p6_merge

如果p6_mode = hybrid(代码生成+润色):

exec: python3 "$ORCH" --action p6_code_generate

→ 一条命令完成全部P6(代码生成全部用例+分批写入+merge+gate pass) → 无需Agent循环调用,等待结果即可

如果p6_mode = strict(严格模式):

exec: python3 "$ORCH" --action p6_batch_info

→ 获得total_batches

对每个批次N=1,2,...执行:

exec: python3 "$ORCH" --action prep_prompt --step P6 --batch-index {N}

→ 读取prompt → Agent生成JSON → write到p6_batch_{N:03d}_agent_output.json

exec: python3 "$ORCH" --action p6_save_batch --batch-index {N}

→ 严格校验(步骤唯一性+步骤-结果对应+占位符检测)

🔴 P6重试规则(strict模式必须遵守):

p6_save_batch返回quality_rejected时,仔细阅读issues中的具体问题
针对性修改后重新生成该批次JSON,再次调用p6_save_batch
最多自动重试2次,不要在重试期间报告给用户
只有连续3次被拒绝(同一批次)才告知用户

全部批次完成后:

exec: python3 "$ORCH" --action p6_merge

完成后输出:

✅ 段落5完成 | 用例:N条 | 冒烟:M条 | 模式:{p6_mode}
📋 请回复「继续」进入质检和导出

📋 段落6:质检 + 导出(P7 + Excel)

用户确认后执行:

🔴 段间验证(必须先执行):

exec: python3 "$ORCH" --action status

确认P6的gate pass存在。如不存在,必须重新执行段落5。

Step 1: P7质量门禁(V3.3.1: 代码自动校验,无需Agent生成JSON)

exec: python3 "$ORCH" --action p7_code_check

→ 代码自动读p5_output.json+p6_output.json,执行C1-C9+C7.1全部11项校验 → 自动生成p7_output.json + p7_report.html + P7.pass.json → ❌ 禁止用step_run --step P7,会被拒绝

Step 2: Excel导出 + 评审推送

exec: python3 "$ORCH" --action step7_export

→ 🔴 step7_export会校验P6用例数量底线 + P7 gate pass(必须由p7_code_check生成) → V4.0.0: 导出成功后自动推送用例到云端评审工具(如已配置),返回cloud_review字段 → 不达标会被拒绝,需要重新执行段落5的P6

完成后:

从step7_export返回的JSON中获取excel_path的实际值
输出状态行:✅ 全部完成 | 用例:N条 | 冒烟:M条 | Excel已生成
🔴 必须在下一行输出MEDIA指令发送文件(独占一行,全大写,路径用实际值):

MEDIA:/root/.openclaw/workspace/xxx.xlsx

🔴 V4.0.0 评审推送闭环:从step7_export返回的JSON中解析cloud_review字段:
- 如果 cloud_review.pushed == True → 输出评审链接给用户: 🔗 在线评审工具: {cloud_review.review_url} (用户可点击跳转评审)
- 如果 cloud_review.pushed == False → 输出提示: ⚠️ 评审推送失败({cloud_review.message}),可回复「重试推送」由Agent执行重试
- 如果JSON不包含cloud_review字段 → 跳过(未配置云端评审)
输出:💡 如需L6经验学习,可将评审结果发给我

⚠️ MEDIA指令是发送文件给用户的唯一方式。不输出MEDIA=用户收不到文件。 ⚠️ 评审链接是V4.0.0闭环的关键环节,必须展示给用户。

用户交互指令

| 用户输入 | 含义 | |---------|------| | 继续/好的/下一步/go | 执行下一段 | | 查看进度 | exec orchestrator.py --action status | | 从P{N}重新开始 | exec: python3 "$ORCH" --action restart_from --step P{N} | | 取消/停止 | 终止流程,保留已完成产物 | | 重试推送 | exec: python3 "$ORCH" --action retry_push |

断点续跑

用户发送"继续"时,如果当前任务有未完成步骤:

exec: python3 "$ORCH" --action resume
→ 获得 next_step,从对应段落继续

错误处理

| 错误 | 处理 | |------|------| | orchestrator返回error | 输出错误信息,🔴 不允许回退到手动模式,必须修复后重试 | | orchestrator返回gate_blocked | 检查前置步骤是否完成 | | orchestrator返回guard_failed | 重新生成JSON重试(最多1次) | | orchestrator返回quality_failed | 按retry_hint重新执行对应步骤 |

引用文件

| 路径 | 说明 | |------|------| | tools/orchestrator.py | 核心流程控制器,15+个action,参数自动化,HMAC签名,云端评审推送 | | tools/truncation_guard.py | 四级截断检测+原子写入+HMAC签名 | | tools/export_excel.py | Excel导出(21列公司标准) | | tools/export_markdown.py | Markdown降级导出 | | tools/export_p0p1.py | P0/P1结构化报告导出(MD+HTML) | | tools/export_prd_review.py | PRD审查结果Excel导出 | | tools/p5_prepare.py | P5测试点合并预处理 | | tools/p6_templates.py | P6 hybrid模式代码生成(11套category模板) | | tools/image_extract.py | docx图片抽取(python-docx) | | tools/image_understand.py | 图片理解调度(vision/OCR/context_only三级降级) | | tools/image_ocr.py | OCR引擎封装 | | tools/image_enhance.py | 图片理解增强聚合 | | tools/model_detect.py | 模型能力检测(视觉能力+预处理) | | tools/test_px_pipeline.py | 图片处理管线集成测试 | | tools/image_api_server/server.py | 腾讯云图片理解API服务端(Flask) | | references/orchestrator_protocol.md | Agent↔orchestrator交互协议 | | references/onboarding.md | Onboarding检查+交互流程 | | references/step0-px.md | Step 0+PX详细指令(prompt参考源) | | references/step1-4.md | P0-P5详细指令(prompt参考源) | | references/step5-7.md | P6-P7+Excel详细指令(prompt参考源) | | prompts/P0_requirement_structuring.md | P0需求结构化Prompt | | prompts/P0.5_prd_quality_review.md | P0.5 PRD质量审查Prompt | | prompts/P0_prd_review_enhance.md | P0 PRD审查增强Prompt | | prompts/P1_feature_tree_generation.md | P1功能点树Prompt | | prompts/P2_test_point_draft.md | P2测试点草稿Prompt | | prompts/P3_risk_identification.md | P3风险识别Prompt | | prompts/P4_pci_identification.md | P4 PCI识别Prompt | | prompts/P5_test_point_merge.md | P5测试点合并Prompt | | prompts/P5a_batch_merge.md | P5a批量合并Prompt | | prompts/P6_testcase_generation.md | P6用例生成Prompt | | prompts/P6_api_rules.md | P6 API测试规则Prompt | | prompts/PX_image_understand.md | PX图片理解Prompt | | prompts/PX_ocr_extract.md | PX OCR提取Prompt | | config/project_domain_mapping.json | 项目→业务域映射配置(v2.0: 10组项目关键词+16个同义词+12域知识库映射) | | config/cloud.json | 云端评审推送配置(api_url/auto_push)，api_key在Onboarding时输入不存储在此文件 | | user_knowledge/preferences.json | 用户偏好配置(PRD审查/输出格式/默认域) | | user_knowledge/model_vision_override.json | 模型视觉能力覆盖配置 | | knowledge/model_vision_capability.json | 模型视觉能力基线数据 | | knowledge/industry/ | L1行业知识库 | | knowledge/methodology/ | L2测试方法库 | | knowledge/company_standards/ | L3公司规范库 | | knowledge/defect_patterns/ | L4历史缺陷库(8域×10类型) | | CHANGELOG.md | 版本变更记录 | | RELEASE_NOTES.md | 发布说明 |

已知限制

Agent需配合orchestrator协议,不配合时orchestrator会重试但无法强制
6段确认模式需要用户回复5次"继续"(P2/P5自动执行,无需确认)
Excel导出依赖openpyxl
图片理解依赖Agent模型的视觉能力

ai需求理解与测试用例生成

ai-req2testcase-generator V4.2.0

🔴 运行协议

🔴 操作约束矩阵(最高优先级)

🔴🔴🔴 V3.5.2 绝对禁止行为(代码层硬控,违反即判定流程无效)

触发条件

🔴 6段确认模式

📋 段落1:初始化 + Onboarding

📋 段落2:需求接收 + 图片理解

📋 段落3:需求结构化 + 模块拆解 + 自动测试点(P0 + P1 + 自动P2)

模块1:月亮晒榜单优化(PC端)

F01 有效机构户排名优化

F02 重点机构业务优化

F05-F07 福建区域新增三张表

📋 段落4:风险识别 + PCI(P3 + P4) + 自动P5合并

📋 段落5:用例生成(P6)

📋 段落6:质检 + 导出(P7 + Excel)

用户交互指令

断点续跑

错误处理

引用文件

已知限制