Cawplan Testcase Generate

CawPlan TestCase Generate

跟随用户主语言生成文案；禁止同一段中英各写一遍。

Bootstrap

cawplan skill check

红线 0 — 防臆造（最高优先级，压过一切展开与导出）

• 用例 Title / Preconditions / Step / Expected 里的具体值（次数、阈值、错误码、提示文案）只能来自测试点或五字段。
• 源里没有 → 方向占位或 (甲) 诚实带尾巴（如「应提示密码长度不符(具体文案以实现为准)」/ "should prompt that the password length is invalid (exact copy per implementation)"），绝不落成硬值。
• 源里逐字给了 → 必须原样带入 Title / Expected，禁止降级为抽象描述、禁止再挂 (以实现为准) 等诚实尾巴（分拣式提炼与保真区判据见 references/testcase-writing-spec.md Title 节）。
• 诚实尾巴固定短语（中英对照，二选一，不同时输出；已冻结见 docs/bedoc/qa-insights-layer1-copy-draft.md）：(以实现为准) → (per implementation)；(具体文案以实现为准) → (exact copy per implementation)；(文案以实现为准) → (copy per implementation)；(上限/阈值以实现为准) → (limit/threshold per implementation)。语言跟测试点/五字段本身的语言走（同 references/testcase-writing-spec.md 通用底线"语言跟需求走"），不是跟当下会话语言走——用例内容是数据，不是界面文案。
• 四法只建议取哪一类值、铺哪几步；细则见 references/test-design-methods.md，但红线 0 不可外包给 reference。

Workflow

1. Resolve target Requirement (entry priority)

On each generate test cases request, resolve the target in this order (fall through):

P2 话术（同义，须有效 binding）：马上生成测试用例 / 按上面的生成用例 / generate test cases from above / expand the test points above / 接着生成用例 / 把上面的展开成用例 / 生成测试用例 / 展开用例 等（与 SPEC hot handoff 同意图）。

有效 binding = product_id + requirement_id both present. Phrasing without binding → fall through to P3 or 兜底.

未归档拦截（P3 + 原 unarchived branch 合并） — 会话有需求草稿和/或测试点草稿/表，但 无 valid requirement_id → 框3「需求还没保存」（见下）。Do not fall through to §2 GET（would return empty and mislead SQA toward generating test points first). Unarchived fast-path is not supported in this release.

框1 · 锁定 Requirement（入口 / 兜底）

触发：上表 兜底；或用户说 生成用例 / 生成测试用例 / 展开用例 等且消息与上下文中无 Requirement 链接、无有效 binding、无草稿（object-unclear）。有效 P1/P2、已保存 Requirement → 不弹。

禁止选项「用上面出好的」（属有效 P2）。

优先 AskUserQuestion（两个选项，每项须带 label + description；工具会自动追加 Other 自由输入行，标题/占位不可自定义——不要在 skill 里定义或手写 Other / 自由输入行；跟随会话语言整框二选一，不同时输出）：

AskUserQuestion 不可用时 — 纯文字降级（逐字；跟随会话语言二选一，不同时输出）：

锁定 Requirement
生成用例前，先确定是哪条 Requirement？
1. 已有 Requirement 链接 —— 选这个，把 Requirement 链接发我
2. 没有 Requirement —— 马上生成并保存到 CawPlan
请回复序号，或直接粘贴 Requirement 链接、或直接说你想怎么做。

Lock Requirement
Before generating test cases, let's confirm which Requirement this is
1. I have a Requirement link — pick this, then send me the link
2. No Requirement yet — generate and save to CawPlan now
Reply with a number, paste the Requirement link directly, or just tell me what you'd like to do.

落点：

• 选「已有 Requirement 链接」→ 请对方发 Requirement 链接；拿到 Requirement 链接后（下条消息或工具自动 Other 框粘贴）→ Portal 解析（见下）；无法解析 → 复述两项 / 请重选。
• 选「没有 Requirement」→ 会话写 resume_intent = testcase，读 cawplan-requirement-analyze skill 接力。

框3 · 需求还没保存

触发：上表 P3；或原 unarchived branch 条件（测试点草稿/表 + 无 requirement_id）。

优先 AskUserQuestion（两个选项，每项须带 label + description；Other 行由工具自动追加，勿定义；跟随会话语言整框二选一，不同时输出）：

AskUserQuestion 不可用时 — 纯文字降级（逐字；跟随会话语言二选一，不同时输出）：

需求还没保存
这份需求还没保存到 CawPlan，先保存再来展开用例
1. 马上保存 —— 存好再接着展开用例
2. 先不保存 —— 先停一下，我再看看这份需求
请回复序号，或直接说你想怎么做。

Requirement Not Saved Yet
This requirement hasn't been saved to CawPlan yet — save it first, then expand test cases
1. Save now — save it, then continue to expand test cases
2. Not yet — pause for now, I'll review this requirement again
Reply with a number, or just tell me what you'd like to do.

落点：「马上保存」→ 会话写 resume_intent = testcase，读 cawplan-requirement-analyze skill 走保存/归档（确认闸照旧），SUCCESS 后回 §2 refresh；「先不保存」→ stop；若 SQA 用工具自动 Other 或自由回复 → 复述 / 按说明处理。

Trigger routing (when intent is ambiguous):

Anti-confusion:

• Object unclear — user says 生成用例 / 生成测试用例 / 展开用例 (or equivalent) with no Requirement in message or context, no valid binding, no draft → 框1 above (not a bare text ask). Missing product_id after link parse → ask in plain language; do not scan product lists.
• Draft already exists + vague "生成用例" again → stop and ask: 重新生成 or 在现有基础上调整/展开?（跟随会话语言：regenerate or adjust or expand on the existing draft?） (prevent overwriting SQA-edited draft).
• A3 never invents new coverage surfaces — gaps go to 存疑清单, suggest back to A2.

Portal URL (parse only — never fetch):

/product/{product_id}/qa-insights/test-suites/requirements/{requirement_id}

• Extract product_id + requirement_id from the string only.
• Forbidden: cawplan api GET {url}, HTTP fetch, or any request to the portal path.

Only requirement_id, missing product_id: ask for product_id or a full Requirement link.

Rebind replaces whole context. One active Requirement at a time.

跨 skill 接力

• 出站（框1「没有 Requirement」、框3「马上保存」、§3 框2「马上生成测试点」）：接力前写入 resume_intent = testcase。
• 入站回归：需求分析归档或测试点流程完成后，按 resume_intent 回到本 skill §2 refresh 续展开。
• A2 §9.5 引导入站：测试点 §9.5 成功回执后 SQA 说「马上生成测试用例」→ 有效 binding 下 P2 热交接，直跑 §2 refresh（无需再贴需求或测试点）。
• 框2「马上生成测试点」：读 cawplan-testpoint-generate skill；该流程只生成并呈现测试点、不自动归档；SQA 确认归档后才回 §2 refresh。若只说「看着不错」未归档，回来仍 test_points.length === 0、会再弹框2 — 预期行为。
• 框1「已有 Requirement 链接」解析成功 → 按 P1 冷交接继续，不弹框3。

2. Refresh before expand (always)

Before expanding (cold or hot), pull live data — library is source of truth. Presentation: execute §1 parse + both GETs silently — no SQA-facing process narration until §9 Opening line (see §9「进场静默」).

cawplan qa-insights requirements get <product_id> <requirement_id>

On outcome: SUCCESS, use envelope data for five fields + module_tree_node_id + metadata (url, etc.).

cawplan qa-insights testpoints list <product_id> <requirement_id>

On outcome: SUCCESS, use data.test_points[] in sort_order. Map each row: id → TestPointId, title → TestPointTitle, tags[] → Tag (/ join if multiple), group → Group.

Five-field drift: if refresh shows five fields (especially constraints) changed since test points were written → one light 存疑 line before expand; do not expand silently.

3. Hard stop (after refresh, before expand)

框2 · 还没有测试点

触发：§2 refresh 后 test_points.length === 0；与 §1 未归档路径（框3）互斥。

优先 AskUserQuestion（两个选项，每项须带 label + description；Other 行由工具自动追加，勿定义；跟随会话语言整框二选一，不同时输出）：

AskUserQuestion 不可用时 — 纯文字降级（逐字；跟随会话语言二选一，不同时输出）：

还没有测试点
这条 Requirement 还没有测试点
1. 马上生成测试点 —— 生成好再接着展开用例
2. 先看看需求内容 —— 读一遍再决定
请回复序号，或直接说你想怎么做。

No Test Points Yet
This Requirement doesn't have test points yet
1. Generate test points now — generate them, then continue to expand test cases
2. Review the requirement first — read it through before deciding
Reply with a number, or just tell me what you'd like to do.

落点：

• 「马上生成测试点」→ 会话写 resume_intent = testcase，读 cawplan-testpoint-generate skill；该流程只生成并呈现测试点、不自动归档；SQA 确认归档后，按 resume_intent 回 §2 refresh 续展开。若只说「看着不错」未归档，回来仍无测试点、会再弹框2 — 预期行为。
• 「先看看需求内容」→ 展示 §2 已拉取的五字段，读完再决定。
• 若 SQA 用工具自动 Other 或自由回复 → 复述 / 按说明处理。

4. Read references (on demand — do not inline into SKILL)

5. Expand test cases

Preview carrier (workbench):

预览一律为对话内结构化 Markdown（表格 / 缩进步骤块 + 行首文字标签），不使用 artifact / 交互组件、不落盘 HTML。真相源是会话内存 cases[]。SQA 内容改动通过对话口述，Claude 更新 cases[] 后只重打受影响部分：改标题 → 重打受影响 Group 块的标题表；改某条步骤 → 只重打该 Group 块内那条展开块，不动其余。默认输出形态 = 首轮按 Group 分块标题表，后续局部展开块，不每轮重打全部。

Expansion boundary (first rule):

• 一条用例 = 一个独立验证目标（完整判据与 ✅❌ 对照表见 references/testcase-writing-spec.md「拆 / 合规则」层 1）。先过层 2 形状分类（A/B、EP、多对象、跨页）,再过层 1 那一问。
• 生成后必答：「这条会不会因为两个不同的验证目标分别挂？挂了我能不能一眼看出是哪个验证目标？」——会挂两次且分不清 → 拆到每条只剩一个验证目标。
• Four methods expand only on archived test points — do not invent coverage.
• Missing surface with no parent test point → 存疑 only（跟随会话语言二选一）: "这一块没有对应的测试点,回去补一条测试点、刷新后再展开。" / "There's no matching test point for this — go back and add one, then refresh and expand it." No orphan cases.
• Every case under the archived main path must have non-empty testPointId + parent test point — in cases[], preview, and export (see §8).
• SQA verbally adds a new case → same rule: must attach non-empty testPointId + parent test point; if none → 存疑 back to A2, not into cases[] / preview / export.

One test point → N cases: split when verification goals differ (不同失败模式 / 不同独立验证目标); merge only when same failure mode, data-only variation and steps can walk each value/object — see references/testcase-writing-spec.md「拆 / 合规则」层 1. Do not skip values listed in A2 titles. A2 粗 = 合法(不改);测试点标题里带取值清单 / 并列措辞时,A3 默认逐项展开成 N 条,不照抄成一条(与上句同源强化)。

Three-tier output rhythm (content axis — Markdown preview only; no CSV on this axis):

本批展开分流（Partial / Full 共用 — 看本批条数，不看池子总量）:

• 适用：SQA 本次请求属于 Partial 或 Full 展开（已有点名或「全部展开」意图）。
• 本批条数 batchCount：这一次要打出 step/expected 块的 case 数。
  • Partial：SQA 点名的条数（如「展开前 25 条」→ 25；「展开第 1、3、5 条」→ 3）。
  • Full：当前 cases[] 中本回合尚未展开的条数（steps / expected 仍为空或视为未展开）。
  • 与 cases[] 总条数、已展开条数无关 — 只数本批。
• 硬顺序（不可跳步）：
  1. 识别 Partial / Full 意图 → 计算本批 batchCount。
  2. batchCount > 10 且 SQA 未免分流已表态？→ 只出框4，禁止铺步骤（即使用户说了「全部展开」；不得因 §9 例外而跳过框4）。
  3. 框4 选「全部铺开」/ batchCount ≤ 10 / 免分流已表态 → 展开 Markdown 预览块 → §9 hint。
• batchCount ≤ 10：照旧直接展开 Markdown 预览块，不问、不停。
• batchCount > 10 且 SQA 未在请求里已表态 → 先不铺步骤，只给 框4「展开方式」（载体分流，非确认闸；禁「确认 / confirm / 是否继续」）：

优先 AskUserQuestion（三个选项，每项须带 label + description；Other 行由工具自动追加，勿定义；跟随会话语言整框二选一，不同时输出）：

AskUserQuestion 不可用时 — 纯文字降级（逐字；跟随会话语言二选一，不同时输出）：

展开方式
本次要展开 N 条,在对话里会很长。怎么弄?
1. 全部铺开
2. 全部带步骤导出 —— 缺步骤的自动补齐
3. 先不展开 —— 换个更小范围,比如「先展开 5 条」
请回复序号，或直接说你想怎么做。

Expansion Method
Expanding all N of these will make this reply very long — how should I proceed?
1. Expand all inline
2. Export all with steps — auto-fill any missing steps
3. Not yet — narrow it down, e.g. "expand the first 5"
Reply with a number, or just tell me what you'd like to do.

• 「全部展开」≠ 已表态：仅说「全部展开」（或同义 Full 档位触发）只表示进入 Full 档位、用于计算 batchCount；不算免分流已表态。batchCount > 10 时仍须先走框4，禁止直接铺开。

• 免分流（已表态则不问）：请求里已额外明确决断要全铺、且话术强于单纯「全部展开」时，直接当「全部铺开」，例如「我知道很长，就是要全铺」「别问，全展开」「不管多长全部展开」— 不先弹框4。

• 边界：这不是给展开加确认闸；≤10 条、或已表态的 >10 条，展开仍无摩擦。框4仅在「本批 > 10 且未表态」时出现。

• Default first pass: title-state Markdown tables grouped by Group (not CSV). 父测试点列是拆分账核心：同一父测试点连出 N 行 = 逐项拆对；只出 1 行 = 可能错合；空 = 孤儿。

• Preview table columns ≠ CSV 13 columns — preview is for human review; export column layout follows assets/testcase-template.csv. 预览层的 同上 是显示缩写；cases[].testPointTitle 与导出 JSON 始终保留全称（见下「预览呈现格式」）。

• 预览一律按 Group 分块（Title / Partial / Full 均适用；即使仅 1 个 Group 也必须分块，禁止单组平铺）：每个 Group 一块，块首为 ### {Group名}；块内表列固定为 # / 用例标题 / 优先级 / 父测试点。禁止在块内再加「分组」列（分组已由块标题表达）。分块仅影响 Markdown 布局，不决定 SQA 点名展开哪些条。

• 父测试点列「同上」（仅 Markdown 预览显示层；cases[].testPointTitle 与 §8 导出永远全称，见下条）：

  1. 块首行强制全称：每个 ### {Group名} 块内表格的第一行，父测试点列必须写全称，禁止 同上（块内无上一条用例可比）。
  2. 「同上」触发条件（须同时满足）：
     • 本行不是该块表格首行；
     • 本行 cases[].testPointTitle 与本块内紧邻上一行的 testPointTitle 逐字完全相同（比的是父测试点列字符串本身，不是用例标题、不是主题相似、不是全局 # 序号）。
  3. 块边界归零：每个新 Group 块开始时，不得延续上一块的「同上」链；跨块禁止 同上 或「同第 N 条」。
  4. 禁止写法：预览中不得出现「同第 N 条」；连续多行 同上 仅表示同一父测试点在本块内拆出多条用例。

• 与 CSV 导出无关（重要）：上述分块与 同上 仅作用于对话内 Markdown 预览。§8 导出时 interim JSON / CSV 每行仍填完整 testPointTitle 与 group（13 列照常，含脚本生成的 Refs），绝不出现 同上 或省略。cases[] 内存真相源始终完整；预览只是渲染层缩写。

预览呈现格式（Markdown only — 不影响 §8 导出）

• Partial expand: SQA names every case — do not proactively suggest which rows to expand. 本批点名条数用于上文 batchCount（见「本批展开分流」）。
• Detail three columns (Preconditions / Step / Expected) are always generated together per case (all or none).
• When expanding steps, follow references/testcase-writing-spec.md **「步骤粒度」**节: after an action, if there is an observable page jump or state change → separate step; do not merge cross-page / cross-state actions into one sentence. Same-page setup with no intermediate observable result may merge (不为拆而拆). Granularity SQA tuned on some rows → on Full expand, apply the same rules to the rest.
• Step/Expected 逐条对应（生成时自查，硬约束）：每条用例展开完 steps / expected 后，当场核对两者行数是否相等；不等 → 立即自行修正后再交付（如把误拆的两步合回一步、或把过粗的一条预期拆回对应几条），使每一步都恰好配一条预期。修正只调整拆分/合并方式，不得臆造新的具体值去凑数（仍受红线 0 约束）。此检查先于下方「Preview self-check」执行，避免带着不配对状态进入预览或导出。

Preview self-check (when generating/updating preview):

• 块首行写了 同上（硬修，非提示）：逻辑上必错、无误报空间。渲染前若发现某 Group 块表格首行父测试点列为 同上（或「同第 N 条」）→ 不得留 ⚠ 也不交付该预览；当场用该行 cases[].testPointTitle 全称写回父测试点列，再输出预览。do not block expand 的其余项仍适用。
• 父测试点列为 同上，但本行 cases[].testPointTitle ≠ 本块内紧邻上一行 cases[].testPointTitle（逐字）→ inline ⚠同上引用错误（软提示，不阻断）
• Step contains verification verbs (验证/检查/确认) → inline ⚠疑似预期混入步骤
• step line count ≠ expected line count（硬修，非提示）：与「块首行写了 同上」同级。渲染前若发现 → 不得只留 ⚠ 就交付；当场按上条「Step/Expected 逐条对应」规则修正 cases[] 后再输出预览。
• Expected contains source-doubtful concrete values → inline ⚠具体值待核 (红线 0 backstop)
• 源已有具体文案/错误码/阈值,但用例未保留（保真回归）：
  • 判定：父测试点（或五字段约束）含源逐字给定的具体值（见 testcase-writing-spec.md Title 节「两步门」），而本条出现以下任一 → 报警：
    • 标题态（steps / expected 为空）：title 用抽象概括替代源里的具体句/码/数，或挂了 (以实现为准) / (具体文案以实现为准) / (文案以实现为准) 等诚实尾巴而源里已有逐字文案；
    • 已展开（本条有 steps / expected）：除标题态情形外，expected 各行明显用抽象或错挂尾巴替代源里与验证点相关的具体文案（源提示句很长而某步 Expected 只含与该步相关的关键片段，可能合法 → 见下「呈现」）。
  • 分状态（勿误报）：
    • 标题态：只查 title；expected 为空不查。
    • 已展开 / fill_then_export 静默补齐后：查 title 且 查 expected 各行。
  • 豁免（不报警）：源里只有方向性描述、无逐字具体值 → 标题/预期用抽象 + 诚实尾巴为正常（与 Walkthrough 登录/素材时长示例一致）。
  • 呈现（硬修 vs 软提示）：
    • 标题态 · title 问题 → 硬修：与「块首行写了 同上」同级，几乎无误报空间。不得只留 ⚠ 就交付；当场按源写回 cases[].title 原文、删掉错挂尾巴，再输出预览。
    • 已展开 · expected 文案比对 → 软提示：inline ⚠源已有文案未保留，不阻断、不自动覆写 cases[]（源句很长而某步只放关键片段等边界由 SQA 判断）。title 若仍抽象化/错挂尾巴 → 仍按标题态硬修。
• 父测试点标题含明显多取值信号（如 5s/10s/15s、普通/多字符、分别…、下限…上限…），但其下只挂 1 条用例 → inline ⚠疑似未展开取值清单，强制回 testcase-writing-spec.md 层 1 那一问。/ 仅在像取值清单时报警；若 / 明显是流程阶段名 / 页面名 / 模块名（如 Config/Idea/Storyboard 流程走通）→ 豁免（一条用例、多 step 跨页，见 spec「步骤粒度」），不得强拆成多条。宁可漏报，不误扩。

SQA edits in preview — row-prefix labels: 【已调整】 / 【新增】 / 【存疑】; deleted rows → "已移除" subsection at preview end (trace, not silent drop). 存疑清单正文 (separate from row labels) still uses A2 format: 〔指向哪〕+〔为什么疑〕+〔建议动作〕. Say "无" if none.

Priority: infer P0–P3 per references/testcase-writing-spec.md (升降规则); script maps to Critical/High/Medium/Low on export.

6. Self-review (internal — do not show SQA a checklist)

Run twice: (1) before title-state preview; (2) before export (含 fill_then_export 静默补齐前).

1. Per references/testcase-writing-spec.md layer 1 — 问 A（该拆没拆）:每条用例,两个验证目标会不会独立失败且分不清?会 → 拆。问 B（防过拆/该合没合）:相邻几条是否同一失败模式下只换数据、能合而未合?是 → 合(受 EP 有效类例外与多对象逐个走约束)。
2. 保真分拣（Title 节）：父测试点含源逐字给定的具体值时 — 标题态：title 须原样保留、未抽象化、未错挂尾巴，否 → 当场修正 cases[].title 后再出预览（硬修）。已展开：title 同上硬修；expected 明显抽象化或错挂尾巴 → 仅标 ⚠源已有文案未保留（软提示，不自动覆写，与 §5 一致）；源句很长而某步只含关键片段可能合法，不误修。细则与豁免见 testcase-writing-spec.md Title 节与 §5「保真回归」。
3. Every case has non-empty testPointId (archived path); orphans do not enter cases[], preview, or export → 存疑 back to A2.

7. Confirm before writing files

8. Export via script (mandatory — no AI-written CSV)

AI produces an export-time snapshot of current cases[] as interim JSON; export_to_csv.js lays out cells only — no improvisation, no inline CSV text, no ad-hoc export code.

框5 · 导出方式

触发：SQA 主动说「导出 CSV」等导出意图，且不是从 §5 框4 已选「全部带步骤导出」进入（框4 已选则 跳过框5，直接 exportMode = fill_then_export）。

优先 AskUserQuestion（两个选项，每项须带 label + description；Other 行由工具自动追加，勿定义；跟随会话语言整框二选一，不同时输出）：

AskUserQuestion 不可用时 — 纯文字降级（逐字；跟随会话语言二选一，不同时输出）：

导出方式
这批用例要怎么导出?
1. 按当前状态导出 —— 没展开的用例只有标题、没有步骤
2. 全部带步骤导出 —— 缺步骤的自动补齐再导,不在对话里铺开
请回复序号，或直接说你想怎么做。

Export Method
How should this batch of test cases be exported?
1. Export as-is — un-expanded cases will export with title only, no steps
2. Export all with steps — auto-fill any missing steps before export, without expanding inline
Reply with a number, or just tell me what you'd like to do.

When to export:

• Triggered only when SQA actively asks (e.g. 「导出 CSV」), or §5 框4 选了「全部带步骤导出」。直接说「导出 CSV」时先走框5，禁止跳过直接 §8。
• exportMode = fill_then_export（框5 选项 2 或框4 选项 2）：导出前须完成静默补齐（见上表）；§9 receipt 须加补齐提示句。
• exportMode = as_is（框5 选项 1）：未展开行保持 steps / expected 为 []。
• May export at any content state (title-only / partial mix / full). Assemble interim JSON from current cases[] after mode handling. Mixed rows legal (see references/csv-template-mapping.md 「草稿态导出」). Export does not lock work state; may export multiple times (timestamp filenames do not overwrite). Do not rename files or add columns.
• Before export: filter out entries with status: 'removed' — preview-only trace; do not put status or removed rows into interim JSON.
• 兜底重查（正常流程下不应触发 — §5「Step/Expected 逐条对应」与「Preview self-check」已在生成/预览时当场修正）：Before export: if any remaining row has steps.length !== expected.length → 先按 §5 规则当场修正 cases[]（不得跳过修正直接报错）；仅当修正后仍不等（如源信息本身无法判断如何配对）→ refuse export, point SQA to fix in preview（跟随会话语言二选一，e.g. "第 3 条步骤与预期数量不一致,先修齐再导" / "Step 3's step count and expected-result count don't match — fix it before exporting"） — do not call §8 and dump script stderr.

Interim JSON contract ({ requirementTitle, cases: [...] }):

Script hard gates (archived main path): empty testPointId / requirementId / title → fail; steps.length !== expected.length → fail.

# Ephemeral path — timestamp avoids $$ cross-invocation collisions; run all three lines in one shell
TMP_JSON="/tmp/a3_export_$(date +%Y%m%d_%H%M%S)_$RANDOM.json"

cat > "$TMP_JSON" <<'EOF'
{ "requirementTitle": "...", "cases": [ ... ] }
EOF

node scripts/export_to_csv.js "$TMP_JSON" -o testcases   # zero npm deps; run from this skill directory

rm -f "$TMP_JSON"

• Default output dir: testcases/ under cwd; override with -o <dir> when SQA specifies.
• On script failure after a valid export attempt → report stderr honestly; fix JSON upstream, retry.
• Forbidden: writing CSV by hand in chat or generating one-off Python/JS export snippets.
• To SQA: do not say "脚本" / "script". exportMode = as_is 时可说「按当前状态导出」/ "Export as-is"; fill_then_export 时不说「按当前状态导出」/ "Export as-is" — 用 §9 补齐提示句。

9. Present (preview + export receipt)

进场静默（§1 解析链接 → §2 拉取 — 至标题清单首轮为止）:

• 适用范围：从 SQA 触发「生成测试用例」/冷交接 / Rebind / 热交接续跑,经 Portal 解析、requirements get、testpoints list,到首次打出标题清单为止。
• 禁止向 SQA 输出任何内部过程或 ID,例如:「Requirement 链接已解析」「product_id=…」「requirement_id=…」「正在拉取…最新数据」「开始按…展开」等。解析与 CLI 照常执行,仅不向 SQA 念过程。
• 例外（仍可/必须对用户说）：缺 product_id 须追问;读失败 / 404 如实报错;§1 框1 / 框3、§3 框2 等硬停;§2 五字段漂移的轻量存疑一行。
• 成功且进入标题清单首轮时：§2 拉取完成后,第一条可见输出 = 下方 Opening line + 标题清单 Markdown(+ 尾部 hint、存疑清单若有)。不在前面加过程旁白。

Opening (title-list first pass — first SQA-visible line after §2 refresh):

• 输出纪律：承接「进场静默」;开场只说「需求(泛指) + 这是标题清单」;禁止念内部过程。其中「需求」为泛指,不填入 Requirement 显示标题。
• Opening line（逐字模板; {N} = test_points.length from GET；跟随会话语言二选一，不同时输出）:

  已读取需求与 {N} 条测试点,先按测试点列出用例标题(未展开步骤): Read the requirement and {N} test points — listing test case titles by test point first (steps not yet expanded):

Preview state (after title table / partial expand / full expand when SQA asked):

• Markdown 预览的**分块、列结构、父测试点「同上」**遵 §5「预览呈现格式」；与 §8 CSV 落盘无关。
• Output the corresponding Markdown preview + one of the three SQA hints below + 存疑清单 (if any).
• Forbidden: agent proactively pasting a full expand table for all cases (context blow-up). Exception — full Markdown preview is allowed only after §5「本批展开分流」已放行（batchCount ≤ 10，或框4 选了「全部铺开」，或免分流已表态）:
  • Not on 「全部展开」alone when batchCount > 10 — that only enters Full tier and must trigger §5 框4 first; do not expand until triage completes.
  • SQA chose 「全部铺开」 from §5 框4「展开方式」, or
  • SQA 免分流已表态（§5：如「我知道很长，就是要全铺」）— still preview, not CSV. Title tables and partial expand blocks are always allowed as Markdown preview.

Three SQA hints (after preview; no word "脚本"; 跟随会话语言每处二选一，不同时输出):

• After title-list preview:

  要改就直接说(改标题、增删);想看某条用例步骤说「展开第 X 条」;要导出就说「导出 CSV」。 Just tell me if you want changes (edit title, add/remove); say "expand case X" to see its steps; say "export CSV" to export.

• After partial expand:

  这 N 条的步骤已展开。想看别的就说「展开第 X 条」或「全部展开」;要导出就说「导出 CSV」(未展开用例,导出时只有标题)。 Steps for these N cases are now expanded. Say "expand case X" or "expand all" to see more; say "export CSV" to export (un-expanded cases will export with title only).

• After full expand:

  全部 N 条已展开完毕。要导出就说「导出 CSV」。 All N cases are now expanded. Say "export CSV" to export.

• Export receipt (after §8 only — thin summary, no case body):

  • 存疑清单 (if any, same list as preview state)
  • Status line（逐字; <路径> from stdout 已导出: ...；跟随会话语言二选一）:

    已导出:<路径>。 Exported: <路径>.

  • Refs hint（Status line 后追加一行；跟随会话语言二选一）:

    CSV 已含 Refs 列;导入 TestRail 时映射到 References 后,可用 testrail-link 回链用例。 The CSV includes a Refs column; map it to References when importing into TestRail, then use testrail-link to link cases.

  • exportMode = fill_then_export 时（框5 选项 2 或 §5 框4「全部带步骤导出」），Status line 后追加一行（逐字；跟随会话语言二选一）:

    已把未展开用例补齐步骤后导出(对话未铺开)。 Un-expanded cases had their steps auto-filled before export (not expanded inline in this conversation).

CSV is an export snapshot; Markdown preview is the in-conversation work state.

Session state (in-conversation only)

• Binding: product_id, requirement_id, latest five fields, module_tree_node_id, test-point rows from GET.
• Draft: in-memory cases[] is the working set. SQA adjusts in chat → update cases[] + re-render affected Markdown preview (default: group-blocked title tables on first pass, local expand blocks afterward — not full re-render every turn). Deleted entries: status: 'removed' on the row (preview "已移除" only). Export is a separate, SQA-initiated commit — not re-export on every tweak; may export multiple times; work state unchanged after export. Partial expand may add one line index e.g. "已展开: #1,#3". Prior expanded content lives in cases[]; a Partial turn only renders rows SQA named this turn.
• No disk state: no .memory, no cross-session cache. Interim JSON exists in /tmp/ only at export instant, then deleted. Markdown preview is chat output, not disk state.

Out of scope (v1): offline CSV edit round-trip (路 B); no is_edited; A3 never POST/PATCH CawPlan.

Walkthrough (Markdown 预览 → 按需展开 → SQA 触发导出)

Setup: Requirement archived; A2 has test point 1.1 "错误账号或密码登录应失败并给出明确提示" (异常, group 登录校验). After §2 refresh, expand to cases.

Step A — "生成测试用例" → §6 self-review → title-state Markdown tables by Group + §9 title-state hint. Do not run §8.

Title-state preview (illustrative — even a single Group uses one block):

登录校验

父测试点含逐字提示文案 → 标题/预期原样保留（illustrative — 独立示例块，编号不与上下示例连续）：

⚠️ 此例仅演示「源里逐字给了提示文案 → title/expected 须原样保留」的机制。 示例句 Please connect a Text input. 是 Walkthrough 道具，不可照抄到其他用例；真实文案只能来自各自测试点或五字段（同 test-design-methods.md 示例数字铁律）。

Setup 补充：同 Requirement 下另有测试点 2.1「未连接任何 Text 输入节点时,点击 Run 应提示 Please connect a Text input.」(异常, group 输入校验)。

输入校验

• 父测试点无引号但英文成句 → 仍属保真区,标题不得改成「应提示明确的必填输入缺失提示(以实现为准)」。
• 与上表登录例对照：登录例源无逐字文案 → 抽象 + 展开后 Expected 可带诚实尾巴；本块源有逐字文案 → 标题与展开后 Expected 均保留原句、不挂尾巴。

多 Group 时父测试点「同上」（块边界归零 + 块首行全称 — illustrative）：

素材时长基础校验

类型与节点独立性

• #4 是新块首行 → 父测试点必须全称（禁止 同上，即使 #3 在上一块末行）。
• #5 与 #4 的 testPointTitle 逐字相同 → 父测试点列可写 同上。
• 跨块禁止让 #4 写 同上 指向 #3（那是跨组误用）。

cases[] in memory (illustrative — not an export file):

{
  "requirementTitle": "账号密码登录",
  "cases": [
    {
      "title": "错误账号或密码点击 Sign In 应失败并给出明确提示",
      "priority": "P1",
      "tag": "异常",
      "group": "登录校验",
      "testPointTitle": "错误账号或密码登录应失败并给出明确提示",
      "testPointId": "019fd7aa-0000-0000-0000-000000000002",
      "requirementId": "019fd634-8ffd-7d62-b46e-32f8132b4520",
      "moduleTreeNodeId": "019fd633-47c8-7be0-a7c5-1ea1179c7195",
      "steps": [],
      "expected": []
    }
  ]
}

Step B — SQA: "展开第 1 条" → output that row's Markdown expand block under ### 登录校验, using #### for the expand header (no confirm, no file). Two granularity examples:

1. 同页可合（不为拆而拆）: 输入与点击同属铺垫、验证点只在登录结果 — merge to one step / one expected (see references/testcase-writing-spec.md 「步骤内拆分判据」).

{
  "preconditions": "1. 当前处于未登录状态",
  "steps": ["在登录页输入错误账号或密码并点击 Sign In 按钮"],
  "expected": ["登录失败，停留登录页并提示账号或密码错误(具体文案以实现为准)"]
}

2. 跨页必拆: follow references/testcase-writing-spec.md **「步骤粒度」**节 Config → Idea → Storyboard table example — do not duplicate; cite that table when explaining cross-page splits.

3. 源有逐字文案（输入校验正例）: 展开后 Expected 须保留源句,不挂尾巴 — 例: "expected": ["界面提示 Please connect a Text input."] （若步骤合为一步一预期;文案须与父测试点一致,见 Title 节保真区。）

Step C — SQA: "导出 CSV" → 框5「导出方式」→ 按选项 as_is 或 fill_then_export（后者静默补齐）→ §8 (filter status: 'removed', pairing check) → §9 export receipt。

Export column layout: assets/testcase-template.csv.

Output & Confirmation

• Title-state first pass → §6 → §5 title Markdown preview → §9 hint (no §8)
• Partial / full expand — 硬顺序：算 batchCount → >10 且未免分流？只框4、禁止铺步骤（含「全部展开」）→ 框4「全部铺开」/ ≤10 / 免分流 → expand → §9 hint；框4「全部带步骤导出」→ 静默补齐 → §8 (fill_then_export) → §9 receipt（含补齐提示）；框4「先不展开」→ 停下（no confirm gate on expand itself; triage is routing only）
• Export CSV (SQA initiates) → 框5「导出方式」→ §8 (filter removed, refuse mispaired) → §9 receipt (as_is 或 fill_then_export)
• Regenerate entire set → §7 confirm → §6 → §5 preview
• Failures → §2 honest error; keep in-memory draft if safe

References

• references/CAWPLAN_OPEN_API.md — Requirement / TestPoints field shapes (§15); CLI reads via cawplan qa-insights requirements get / testpoints list
• references/test-design-methods.md
• references/testcase-writing-spec.md
• references/csv-template-mapping.md