# 测试计划 → 自动化 转换提示词（执行总纲）

> **配合主提示词使用**。本文件是「按测试计划驱动转换」的执行总纲:规定**做什么、按什么优先级做、每层做到什么程度**。
> 通用机制(技术栈/DeviceDriver/脚本模板/元素发现/边跑边写/截图/报告)遵循 `prompts/ones_to_automation.md`;
> 必测项(P0)的专项细节遵循 `prompts/must_test_conversion.md`。三者叠加使用。
> 计划全文见 `docs/UI自动化测试计划.docx`(由 `docs/generate_test_plan.py` 生成)。

---

## 0. 核心原则

- **优先级驱动,不绑定周次**:严格按 P0 → P1 → P2 → P3 顺序推进,**高优先级层达到退出标准后再投入下一层**。
- **必测是闸门**:P0 是提测/版本准入门禁,任何版本变更优先保 P0 绿。
- **AI 边跑边写**:首台建模、同品类复用台仅改配置;人力预估按 AI 辅助口径(单维度首台 0.2-1 人日、复用台 0.1-0.3 人日)。
- **实际人力 1 人**:四层串行;P0 内「控制轨(不依赖串口)」可先行,「添加轨」待嵌入式串口框架就绪后插入。

---

## 1. 四层优先级总览

| 层 | 范围 | 来源 | 落点(目录/维度) | 退出标准 | AI预估 |
|---|---|---|---|---|---|
| **P0 必测项** | 各单品添加 + 核心控制(双协议) | ONES plan `CQz9YCNX` / `must-test.manifest.ts` | `{device}_connect` / `{device}_control` | 通过率≥95%(门禁) | ~40-48 人日 |
| **P1 单品探索** | 82 款主流程冒烟(card+核心control) | 单品模板 | `{device}_card` + 核心 control | 全单品冒烟通过 | ~25 人日 |
| **P2 全功能** | 全维度回归(card/control/setting/scene/logs) | 各品类 ONES 用例库 | 全维度文件,按品类批量 | 通过率≥85%、覆盖100% | ~100 人日 |
| **P3 平台** | 账号/房间/消息/家庭分享/场景等 | App 平台用例库 | `tests/automation/` 等平台 | 平台用例通过 | ~12 人日 |

---

## 2. 逐层执行指引

### P0 必测项（最高优先,先做）
- **完全遵循 `prompts/must_test_conversion.md`**:用 `test-plan/must-test.manifest.ts` 作为清单(187 条 = 添加73 + 功能9 + 控制105step)。
- **先控制轨**(不依赖串口):双协议 105 step,落到各 `{device}_control.test.ts`,打 `[P0][ONES:号#step][协议]` 标记。
- **后添加轨**(待串口框架):serial_controller / connect_base_helper / wifi_connect_helper 就绪后,73 条添加落到 `{device}_connect.test.ts`。
- 结果按锚点 step 级回写 ONES plan `CQz9YCNX`。**P0 不达 95% 不进入 P1。**

### P1 单品探索
- 为全部 82 款单品各写一套**主流程冒烟**:`card`(首页卡片可见)+ 核心 `control`(开关/主模式响应)。
- **复用 P0 已建的 control helper**,单品只补 card 与主流程断言。广度优先、深度浅。
- 退出:每款单品冒烟通过。

### P2 全功能
- 全维度回归。**按品类批量**(高复用→中复杂→新品):同品类调通首台后改设备名配置扩展,沉淀 `*_helper`。
- 来源 = 对应品类 ONES 用例库(非必测项库);按主提示词「读取用例来源」流程拉取转换。
- 维度:card/control/setting/scene/logs(logs 可选)。新品 UI 需从 Figma/UX 重新分析(见 [[reference-figma-designs]]、[[feedback-ux-coordinate-workflow]])。

### P3 平台
- 跨单品平台功能:账号(注册/登录/登出/忘记密码/第三方)、房间/家庭分享3.0/分组、消息中心3.0、商城、我的、小组件、场景3.0联动。
- 含必测项里 ~12 条平台项 + App 平台用例库。落到 `tests/automation/` 等平台测试。

---

## 3. 每层通用工作流

1. **选层**:确认当前应做的最高未完成层(P0→P3)。
2. **拉用例**:P0 用 manifest;P2/P3 用 ONES CLI 从对应品类/平台用例库读取(主提示词「读取用例来源」)。
3. **边跑边写**:首轮生成→运行→按真实页面源码修元素/坐标,直到通过(主提示词「迭代调试流程」)。
4. **回写 ONES**:P0 按 step 锚点(must_test_conversion §9);其余按用例名匹配(主提示词「ONES 测试计划集成」/ `utils/ones-sync.ts`)。
5. **核对退出标准**:达标才进入下一层;记录 AI 实际工时,校准预估。

---

## 4. 调整计划

计划是生成产物。如需改优先级/范围/人力预估,改 `docs/generate_test_plan.py` 后 `python3 docs/generate_test_plan.py` 重新生成 docx,不手改 docx。

---

## 相关
主提示词 `prompts/ones_to_automation.md` · 必测项 `prompts/must_test_conversion.md` ·
[[project-must-test-ones-source]] · [[project-maestro-conversion]] · [[feedback-test-case-reuse]] · [[feedback-manual-navigation]]