测试用例文档（writing-testcase）¶

目标：根据**需求描述**或**指定 SRS**，为 MyApps/OBPM 应用产出可手工执行的测试用例 Markdown。本技能**只写用例文档**，不落盘业务 XML、不写自动化脚本。

模板见 testcase-template.md；写法示例见 examples.md。

产出物¶

部分	文件名	形态
总览（含场景清单）	`00-overview.md`	Markdown
场景用例	`场景-{名称}.md`	Markdown

落盘位置（先询问）¶

**首次写入前必须询问**落盘目录（用户已明确指定路径时可跳过）：

SRS 下 testcase/（默认） — 在 SRS / 需求文档同级下的 testcase/ 子目录写入 00-overview.md 与 场景-*.md
其它目录 — 由用户给出目标路径后再写

规则：

有 SRS/需求文档路径时：默认选 1；用户选 2 时再要具体路径
仅有粘贴的需求描述、无文档路径时：**不能**用默认 1，须问目标目录（或请用户先指定 SRS 路径）
目录不存在则先创建；这些 Markdown **不进**平台索引

# 选项 1 示例（默认）
{SRS所在目录}/testcase/00-overview.md
{SRS所在目录}/testcase/场景-{名称}.md

# 选项 2 示例
{用户指定目录}/00-overview.md
{用户指定目录}/场景-{名称}.md

何时触发¶

用户要写测试用例 / 用例文档 / 验收用例 / 测试设计
提供需求描述或 SRS 路径
规划完成后要求补 QA 用例

输入¶

来源	规则
需求描述	直接使用；不足时一次追问 1～2 个关键问题
SRS 路径	读取后作为主需求源；默认落盘基准为 `{SRS所在目录}/testcase/`
`PLAN.md` / `DATABASE_SCHEMA.md`	存在则作补充；冲突以用户指定的 SRS/需求描述为准，差异写入总览

未明确软件名时：从路径或 PLAN 推断；仍不清则先问英文 name（写入总览元数据即可）。

工作流（门禁）¶

读需求（描述 / SRS / 可选 PLAN·SCHEMA）
  → 【询问】落盘位置：SRS 下 testcase/（默认） / 其它目录
  → 抽取业务场景 → 写 00-overview.md（清单可勾选；索引可先空）
  → 【门禁】用户勾选/增删并确认
  → 仅为已确认场景写 场景-*.md
  → 回写总览覆盖矩阵与用例索引
  → 请用户抽查

未确认落盘目录前，禁止写入任何用例文件
未确认场景清单前**禁止**写 场景-*.md
用户明确「跳过确认、全部生成」时可一次落盘（仍须已确定落盘目录）
小改动只更新相关场景文件与总览索引

覆盖要求（默认档位 C）¶

每个纳入场景至少 1 条主路径（P0）；并按需求覆盖：

异常/边界（必填、格式、重复提交、非法流程操作等）
权限成对（有权能做 / 无权不可见或不可做）
流程（提交/审批/驳回/撤回等与状态）
跨模块（菜单→表单/视图→待办等完整路径）

用例字段（必须完整）¶

用例编号、标题、优先级、角色/账号、关联需求、模块/场景标签、前置条件、测试数据、操作步骤、预期结果、通过准则、备注。

编号：TC-{场景缩写}-{三位序号}。

写作规范¶

步骤写真实操作，禁止「验证某某功能」空步骤
只写业务与操作，不写 iScript/SQL（除非需求要求验脚本效果）
语气与结构对齐 examples.md

不做¶

自动化脚本、业务 XML、改 PLAN/SCHEMA、替代缺陷管理系统

与上下游¶

需求/SRS（+ 可选 PLAN/SCHEMA）
  → 确认落盘目录（SRS 下 testcase/ 默认 / 其它）
  → writing-testcase → 00-overview.md + 场景-*.md

可与 plan-application 并行或其后；不阻塞 generate-*。