prd-to-xmind-testcases

name prd-to-xmind-testcases description 将 Markdown PRD 按复杂度自适应解析为可导入 XMind 的测试用例树，并输出 Markdown、JSON、CSV 与 pipeline-output.json。适用于读取当前 PRD，按需触发 test-knowledge-retrieval，消费 context package，执行 analysis-lite 或完整系统建模，经过 testpoint 与 testcase-expansion 矩阵展开后生成测试用例。 PRD 转 XMind 测试用例 目标 将当前 PRD 转换为可导入 XMind 的测试用例树，并同步输出 JSON、CSV、pipeline-output.json，供 UI DSL、Playwright、API 自动化和 Traceability 后续链路使用。 本 skill 采用复杂度自适应 pipeline： simple： analysis-lite -> testcase normal： analysis -> testpoint -> testcase-expansion -> testcase complex： assets -> plantuml -> analysis -> testpoint -> testcase-expansion -> testcase 所有 pipeline 前置执行： Phase 0: complexity-analysis Phase 0.3: context-retrieval Phase 0.5: context-consumption 职责边界 负责： 读取当前 Markdown PRD 判断复杂度并选择 pipeline 在需要历史上下文时触发 test-knowledge-retrieval 消费 context-retrieval.md 与 context-package.json 生成 context-reference.md 执行轻量分析或完整结构化分析 将测试点展开为 testcase expansion matrix 生成 Markdown / JSON / CSV / pipeline-output.json 不负责： 扫描知识库 直接调用 test-knowledge-mcp 直接读取知识库根目录 自己做 metadata 提取、召回、rerank 解析 .xmind 生成自动化脚本 执行测试 Capability 强约束 必须读取 references/capability-abstraction.md 。 文件系统操作必须通过 filesystem capability： mkdir write_file read_file list_dir 图片处理必须通过 image capability： download_image classify_image ocr_image extract_flow_elements 禁止： 直接写文件、创建目录、读取目录 直接下载图片、直接 OCR、直接图片分类 在 capability 不可用时自行兜底 Knowledge Retrieval 依赖 必须读取： references/retrieval-trigger-strategy.md references/context-package-schema.md references/context-validation.md references/context-consumption.md references/context-compression.md 调用链路只能是： prd-to-xmind-testcases -> test-knowledge-retrieval -> test-knowledge-mcp -> context-package.json -> context-consumption / analysis / testpoint / testcase 禁止： prd-to-xmind-testcases -> test-knowledge-mcp .md 是 AI source。 .xmind 只能作为 human preview / traceability 路径。 输出路径规则 所有运行产物必须写入项目根目录下、与 .codex 同级的 ./<delivery-name>/ ，禁止写入 .codex/ 或 skill 目录。 ./<delivery-name>/assets/ ./<delivery-name>/plantuml/ ./<delivery-name>/analysis/complexity-analysis.md ./<delivery-name>/analysis/context-retrieval.md ./<delivery-name>/analysis/context-package.json ./<delivery-name>/analysis/context-reference.md ./<delivery-name>/analysis/analysis-lite.md ./<delivery-name>/analysis/structured-analysis.md ./<delivery-name>/analysis/testpoint-model.md ./<delivery-name>/analysis/testcase-expansion.md ./<delivery-name>/testcase/xmind-testcases.md ./<delivery-name>/testcase/xmind-testcases.json ./<delivery-name>/testcase/xmind-import.csv ./<delivery-name>/pipeline-output.json Pipeline Overview 所有 phase 必须遵守 references/loading-strategy.md ，只读取当前 phase 允许的 references。 必须先执行 Phase 0 -> Phase 0.3 -> Phase 0.5 ，再按复杂度执行核心阶段： simple：2 phase analysis-lite testcase normal：4 phase analysis testpoint testcase-expansion testcase complex：6 phase assets plantuml analysis testpoint testcase-expansion testcase testpoint 不是最终 testcase。normal / complex 禁止跳过 testcase-expansion 。 Phase 0: complexity-analysis 当前 phase 必须遵守 references/loading-strategy.md 中 complexity-analysis 的 loading strategy。 读取 references/complexity-analysis.md 。 目标： 读取 PRD 判断复杂度： simple / normal / complex 选择 pipeline 记录跳过阶段和原因 输出： ./<delivery-name>/analysis/complexity-analysis.md 必须包含： PRD 名称 system / module 推断 图片数量 流程图 / 时序图可能性 状态、角色、依赖、异步、事务、补偿、复杂规则判断 complexity selected_pipeline skipped_phases skip_reason Phase 0.3: context-retrieval 当前 phase 必须遵守 references/loading-strategy.md 中 context-retrieval 的 loading strategy。 读取 references/retrieval-trigger-strategy.md 与 references/workflow-modeling.md 。 目标： 基于当前 PRD 和 complexity-analysis.md 构建 retrieval query 调用/切换 test-knowledge-retrieval 校验 context-retrieval.md 与 context-package.json 是否存在 retrieval query 至少包含：system、module、business_objects、interfaces、states、roles、upstream/downstream_dependencies、workflow / journey、keywords、risk_keywords。 如果 context-package.json 不存在、非法、过期，或当前 PRD 与 context package 不匹配，必须重新执行 test-knowledge-retrieval 。 执行 retrieval 时至少传递：当前 PRD、 complexity-analysis.md 、delivery-name、输出目录、retrieval query。 输出： ./<delivery-name>/analysis/context-retrieval.md ./<delivery-name>/analysis/context-package.json Phase 0.3 只负责构建 query、调用 retrieval skill、校验 retrieval 输出。 Phase 0.3 不负责 search_context 、 read_context_documents 、metadata extraction、rerank、knowledge indexing；这些必须由 test-knowledge-retrieval 和 test-knowledge-mcp 负责。 禁止 prd-to-xmind-testcases 自行伪造 retrieval 结果。 Phase 0.5: context-consumption 当前 phase 必须遵守 references/loading-strategy.md 中 context-consumption 的 loading strategy。 读取： references/context-consumption.md references/context-validation.md references/context-compression.md references/traceability-rules.md 目标： 校验 context package 压缩历史上下文 识别影响范围、冲突、回归候选、风险候选、上下游影响 生成当前 skill 使用的压缩上下文 输出： ./<delivery-name>/analysis/context-reference.md context package 缺失、非法、retrieval 不可用时，进入 degraded context mode，但继续后续 pipeline。 Phase analysis-lite 当前 phase 必须遵守 references/loading-strategy.md 中 analysis-lite 的 loading strategy。 读取 references/analysis-lite.md 。 适用：simple。 目标： 不做完整 6 大建模 抽取 testcase 所需最小 expansion model 检查 context 中的 regression / risk / workflow / upstream / downstream impact 输出： ./<delivery-name>/analysis/analysis-lite.md simple 不生成 testcase-expansion.md ，但 analysis-lite.md 必须内置 lightweight expansion matrix。 analysis-lite 不是功能点摘要，而是 simple testcase generation 的最小 expansion model。 即使是 simple，也必须展开：主流程、分支流程、异常流程、regression hits、workflow hits、risk hits。 simple expansion 优先覆盖：主流程、高频 workflow、regression candidates、历史风险、边界值。 禁止 simple pipeline 一个功能点只生成一条 case。 如果存在 regression/risk/workflow 命中，最终 testcase 必须落地对应用例或写入 skip reason。 Phase 1: assets 当前 phase 必须遵守 references/loading-strategy.md 中 assets 的 loading strategy。 适用：complex。 目标： 提取 PRD 图片 下载图片 建立图片索引 输出： ./<delivery-name>/assets/ ./<delivery-name>/assets/image-index.md 只处理当前 PRD 中的图片。simple / normal 禁止强制走图片 pipeline。 Phase 2: plantuml 当前 phase 必须遵守 references/loading-strategy.md 中 plantuml 的 loading strategy。 适用：complex。 目标： 分类图片 对流程图 / 时序图提取结构化元素 生成 PlantUML 中间产物 输出： ./<delivery-name>/plantuml/*.puml ./<delivery-name>/plantuml/index.md 原型图、截图、页面图默认不转 PlantUML。 Phase 3: analysis 当前 phase 必须遵守 references/loading-strategy.md 中 analysis 的 loading strategy。 读取 references/prd-structured-analysis.md 。 适用：normal / complex。 目标： 基于当前 PRD、context-reference、context-package 和必要中间产物进行完整建模 完成 6 大建模维度 回答 8 个强制建模问题 做完整性检查 输出： ./<delivery-name>/analysis/structured-analysis.md 历史上下文必须参与需求点拆分、影响范围、规则复用、冲突识别和回归候选判断，但不能覆盖当前 PRD。 Phase 4: testpoint 当前 phase 必须遵守 references/loading-strategy.md 中 testpoint 的 loading strategy。 读取 references/testpoint-modeling.md 。 适用：normal / complex。 目标： 将 structured-analysis 压缩为测试点模型 动态输出测试点分类 将历史命中的 reused/regression/risk/workflow 转成测试点或待确认项 输出： ./<delivery-name>/analysis/testpoint-model.md 禁止把完整分析复制进 testpoint。禁止把全部历史用例无脑转为回归测试点。 Phase 4.5: testcase-expansion 当前 phase 必须遵守 references/loading-strategy.md 中 testcase-expansion 的 loading strategy。 在加载 domain profiles 前，必须执行 references/profile-selection-heuristic.md 。 selected_domain_profiles 必须来源于 references/profile-selection-heuristic.md 的 rule-based selection output。 读取： references/testcase-expansion.md references/domain-expansion/generic.md 按 domain profile 选择规则读取额外 profile 适用：normal / complex。 目标： 将 testpoint 展开为 expansion matrix 将测试点按业务维度、状态、数据、角色、配置、异常、workflow、历史回归等维度组合 生成可执行 testcase groups 生成 expected_case_count domain profile 必须按 system、module、workflow、business objects、terminology 推断。 domain profiles 必须包含结构化 Markdown frontmatter metadata，用于后续 profile routing 与 heuristic selection。 如果无法明确判断领域，只允许读取 references/domain-expansion/generic.md 。 禁止无法判断领域时同时加载多个无关 profile。 testcase-expansion.md 必须记录 selected_domain_profiles 与 selection_reason 。 domain profiles 与 examples 必须遵守 references/loading-strategy.md 。 输出： ./<delivery-name>/analysis/testcase-expansion.md 禁止： testpoint -> testcase 直接生成 一个测试点只生成一条代表性 case 把具体业务组合硬编码进主流程 Phase 5: testcase 当前 phase 必须遵守 references/loading-strategy.md 中 testcase 的 loading strategy。 读取： references/xmind-output-format.md references/pipeline-output-schema.md references/traceability-rules.md 输入： simple： analysis-lite.md normal / complex： testpoint-model.md + testcase-expansion.md 所有复杂度：当前 PRD、 context-reference.md 、 context-package.json （如存在） 输出： ./<delivery-name>/testcase/xmind-testcases.md ./<delivery-name>/testcase/xmind-testcases.json ./<delivery-name>/testcase/xmind-import.csv ./<delivery-name>/pipeline-output.json Markdown 必须对齐知识库历史用例格式，只承载 XMind 树。traceability、context_source、source_reason、ai_source_path、xmind_path 必须进入 JSON / CSV / pipeline-output.json。 必须统计 actual_case_count 。 如果 actual_case_count 明显低于 expected_case_count ，必须输出 case_count_warning ，写入 pipeline-output.json ，并给出 case_count_reason ： { "case_count_warning" : true , "expected_case_count" : 80 , "actual_case_count" : 32 , "case_count_reason" : "workflow branches not fully expanded" } case 数量不是唯一目标，但 expansion coverage 必须满足 workflow / regression / risk 覆盖。 关键禁止项 禁止： 删除 degraded context mode 删除 workflow awareness 删除 context validation 删除 filesystem / image capability 强约束 删除 .md / .xmind 边界 删除 pipeline-output.json 删除 traceability 删除 retrieval dependency 删除 context package 跳过 testcase-expansion 在主流程硬编码具体业务规则 将 references 内容重新塞回 SKILL.md 因历史上下文缺失而终止整个 testcase pipeline 资源引用 必须遵守 references/loading-strategy.md 。 SKILL.md 只定义 phase orchestration contract；详细 required / optional / forbidden reference rules 由 references/loading-strategy.md 统一定义。 必须按阶段读取对应 reference。不要一次性加载全部 references。 domain profiles 按需读取。默认只读取 references/domain-expansion/generic.md ；只有明确命中领域语义时，才允许加载额外 profile。 domain profiles 必须包含 profile_id / profile_type / display_name / description / match_systems / match_modules / match_keywords / match_workflows / match_business_objects / priority / related_profiles / fallback_priority frontmatter。 references/loading-strategy.md references/capability-abstraction.md references/complexity-analysis.md references/retrieval-trigger-strategy.md references/context-consumption.md references/prd-structured-analysis.md references/testpoint-modeling.md references/testcase-expansion.md references/profile-selection-heuristic.md references/xmind-output-format.md references/pipeline-output-schema.md references/error-handling.md references/domain-expansion/generic.md 领域明确命中时再按需读取 references/domain-expansion/*.md examples 仅用于 few-shot，不得当作主规则。 完成状态 每个阶段完成后只输出简短状态： [✓] complexity-analysis 完成 [✓] context-retrieval 完成 [✓] context-consumption 完成 [✓] assets 完成 [✓] plantuml 完成 [✓] analysis-lite 完成