# App Test Report

> 根据产品 APP 规格书或优化点，生成 APP 发版/上架测试报告大纲与测试用例（输出 .docx）。 Use when the user asks to write APP测试报告、测试大纲、测试用例、新品上线测试、 已知问题优化上架测试、发版测试报告，或提供 APP 规格书要求生成测试用例。

- Skill: `lareina0011/app-test-report` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add lareina0011/app-test-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lareina0011/app-test-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: lareina0011 (https://skillmd.com/u/lareina0011)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/lareina0011/app-test-report

---


# APP 发版上架测试报告

按用户意图选择模式后生成大纲。两种模式输出结构不同，勿混用。

**最终交付格式：一律为 `.docx`（Word）。不要用 Markdown / txt 作为最终交付物。**  
（工作说明、中间草稿可用 Markdown；交给用户审阅与落盘文件必须是 `.docx`。）

**正式报告统一落盘路径（模式 A/B 皆适用）：**  
`D:\work\APP发版上架测试报告\正式测试报告\`  
生成前若目录不存在则创建；文件名如 `{版本}APP测试报告.docx`。仅当用户明确指定其他路径时才改存别处。

## 模式判断

| 用户情况 | 模式 | 参考样例 |
|---------|------|---------|
| 新品上线，并提供/引用 APP 规格书 | **模式 A：新品全量测试** | `V2.0.34APP测试报告.docx` |
| 已知问题优化、修复、文案/SDK 调整等小版本上架 | **模式 B：优化回归模版** | `V2.0.23`（壳+老品优化收尾）；短文备选 `1.7.73`/`1.7.75` |
| 未说清 | 先问一句：新品规格全量，还是优化点回归？ | — |

详细说明与空白 Word 模版：
- [new-product-template.md](new-product-template.md) → 空白稿 [new-product-blank-template.docx](new-product-blank-template.docx)
- [optimization-template.md](optimization-template.md) → 空白稿 [optimization-blank-template.docx](optimization-blank-template.docx)

生成 Word 时优先用 `python-docx`（见 [scripts/generate_templates.py](scripts/generate_templates.py) 的字体写法）。需要时复制空白模版再填内容，或按同等样式新建 `.docx`。

---

## 模式 A：新品全量测试（规格书 → 用例）

### 输入

用户提供：产品 APP 规格书（docx/pdf/md/截图文字均可）、产品型号、APP 版本号（可选）、涉及老品回归范围（可选）。

若规格书未给全，缺什么问什么：产品名称/型号、APP 版本、测试环境、双端范围、是否含老品回归。

### 工作流

1. **读规格书**，拆出功能模块（配网、主页状态、工作模式、智慧场景、设置、记录、故障、引导等）。
2. **对齐报告结构**（见下方「文档骨架」与 [new-product-template.md](new-product-template.md)）。
3. **按模块写用例**：从规格书提取参数范围、默认值、互斥、联动、记忆逻辑，写入「测试内容 / 预期结果」。
4. **补通用项**：异常与边界、双端（iOS/Android）、与机器联调相关项；若有老品，加回归清单。
5. **优先级**：核心控制/参数/互斥/联调 → 高；展示/引导/次要 UI → 低（与 V2.0.34 风格一致，可用 高/低）。
6. **输出 `.docx`**：写入 `D:\work\APP发版上架测试报告\正式测试报告\`，文件名如 `{版本}APP测试报告.docx` 或用户指定名。可先基于 `new-product-blank-template.docx` 扩展。
7. **「是否通过 / 备注」**列留空，供实测填写（不要默认填 `y`）。

### 文档骨架（对标 V2.0.34）

Word 内结构：

- 标题：`APP测试报告`
- 项目名称 / 测试环境 / 测试时间
- 表格：测试基本信息（测试产品、APP版本号、测试类型、测试系统、测试设备、测试人员）
- 分章：`一、{产品A}` → `1. {模块}测试` → 用例表列：`序号 | 测试项 | 测试内容 | 预期结果 | 优先级 | 是否通过 | 备注`
- 多产品分章；含异常边界、老品回归（如有）

### 用例写作规则

- **一条用例一事**：测试项短名；测试内容写操作步骤；预期结果写可判定现象（含数值范围、默认值、禁用态、弹窗文案要点）。
- **规格数值原样写入**：时长档位、温度、水量步进、字数限制等必须来自规格书，禁止臆造。
- **互斥/联动单独成条**。
- **多产品**：每产品独立章节，模块编号按章内连续。
- **覆盖检查**：规格书每个可交互能力至少 1 条正向；关键参数加边界；关键状态加展示与操作限制。

### 文档规范（.docx）

来自《测试报告文档规范》：
- 标题：黑体小二；正文/表格：宋体小四；行距按规范统一。
- 英文字母/数字：Times New Roman。
- 内容须含：测试范围、测试内容、预期结果、优先级；每次测新品须覆盖相关老品回归（涉及 APP 与小程序上架）。

---

## 模式 B：已知问题优化（回归模版）

### 输入

用户给出优化点/修复点，或只要空白模版后续自填。可附 APP 版本号、涉及机型。

### 工作流

1. 判定为优化/修复上架 → 用 **V2.0.23 报告壳**，不要生成新品那种整机全量模块用例。
2. **正文只写优化点**：每个优化/修复点 → 测试范围一行 + 一章用例表（可对标 V2.0.23「13. 老品优化」写法）。
3. **最后一章固定**：`已上线产品回归测试`（对标 V2.0.23 TC-108：相关型号连接、基础功能使用正常）。
4. 若用户只要模版 → 交付 [optimization-blank-template.docx](optimization-blank-template.docx)（空白模版可仍放 skill 目录；正式填好的报告一律进下方统一路径）。
5. 若用户列出优化点 → 生成填好的 `.docx` 到统一路径。用户说「帮我填进去」→ 只改对应章节。
6. 仅当用户明确要「上架内容三段短文」时，才退回 1.7.x 短文格式。

### 模版结构（对标 V2.0.23）

见 [optimization-template.md](optimization-template.md) 与 [optimization-blank-template.docx](optimization-blank-template.docx)。

```text
APP测试报告 + 项目名称/环境/时间
1. 测试概述 + 测试基本信息
1.1 测试范围（M01…=优化点；Mn=已上线产品回归测试）
2. M01 {优化点1} 用例表
…
N. 已上线产品回归测试（连接、基础功能使用正常）
```

### 写作规则

- 用例重心在**优化点**，禁止顺便铺开配网/全模式/全场景全量表。
- 用例列对齐 V2.0.23：`用例编号 | 测试项 | 前置条件/操作步骤 | 预期结果 | 优先级 | 是否通过`。
- 回归章保持冒烟粒度；波及机型写全；「是否通过」留空。

---

## 输出约定

- **最终文件格式：`.docx`（也可用 `.doc`，优先 `.docx`）。**
- **默认目录：`D:\work\APP发版上架测试报告\正式测试报告\`**（不存在则创建）；生成后告知完整路径。
- 标题统一「APP测试报告」（模式 A/B 皆可）；模式 B 短文例外时可不加长标题。
- 自检：模式正确、优化点有对应用例、末尾有已上线回归、通过列留空、扩展名是 `.docx`、文件已在统一目录。
- 若该目录已有同版本报告，表格列与章节命名与之对齐（或按用户要求覆盖/另存）。