# 开发测试任务提示词构建方法

**版本**: 1.0.0
**最后更新**: 2026-04-18
**维护者**: 项目经理 Agent

---

## 1. 概述

本文档说明如何使用 8 类任务模板和任务文件，组装出完整的、可直接执行的提示词。

### 使用场景

- `项目` pane 分发任务到 `后端`/`前端`/`测试` pane
- 目标 pane 的 Agent 读取模板 + 任务文件，自行拼接为完整提示词执行

---

## 2. tmux 执行环境

### Session 和 Pane 映射

| Pane | 名称 | 角色 | 模板映射 |
|------|------|------|---------|
| pane 0 | 项目 | 项目经理 | 分发任务、追踪进度 |
| pane 1 | 后端 | 后端 + 桌面端 | 模板 1(后端)、2、3、7 |
| pane 2 | 前端 | 前端 | 模板 1(前端)、4、5、7 |
| pane 3 | 测试 | 测试 | 模板 1(测试)、6、8 |

### 环境重置流程

1. 检查目标 pane 是否为新启动的 `cc` 环境
2. 如不是：发送 `/exit`，等待退出，重新启动 `cc`
3. 通过 `scripts/tmux-send-prompt.sh` 发送简短提示词到目标 pane

### 分发示例

```bash
# 分发 M4-001 到后端 pane（桌面端服务开发）
scripts/tmux-send-prompt.sh %1 "请读取任务文件 /workspace/tasks/M4-001-desktop-xxx.md，对应模板为 /workspace/tasks/任务提示词模板-桌面端服务开发.md"

# 分发 M4-003 到前端 pane（UI布局和开发）
scripts/tmux-send-prompt.sh %2 "请读取任务文件 /workspace/tasks/M4-003-frontend-xxx.md，对应模板为 /workspace/tasks/任务提示词模板-UI布局和开发.md"
```

---

## 3. 模板与任务映射

### 模板文件清单

| # | 模板类型 | 文件名 | 任务数 |
|---|---------|--------|--------|
| 1 | 脚手架搭建 | `任务提示词模板-脚手架搭建.md` | 3 |
| 2 | 后端API开发 | `任务提示词模板-后端API开发.md` | 4 |
| 3 | 桌面端服务开发 | `任务提示词模板-桌面端服务开发.md` | 7 |
| 4 | UI布局和开发 | `任务提示词模板-UI布局和开发.md` | 5 |
| 5 | 前端组件开发 | `任务提示词模板-前端组件开发.md` | 7 |
| 6 | 测试编写 | `任务提示词模板-测试编写.md` | 7 |
| 7 | 部署打包 | `任务提示词模板-部署打包.md` | 3 |
| 8 | E2E测试 | `任务提示词模板-E2E测试.md` | 1 |

### 任务→模板映射表

| 任务编号 | 模板类型 | 执行 pane |
|---------|---------|----------|
| M1-001 | 脚手架搭建 | 后端 |
| M1-002 | 脚手架搭建 | 前端 |
| M1-003 | 脚手架搭建 | 测试 |
| M2-001 | 后端API开发 | 后端 |
| M2-002 | 前端组件开发 | 前端 |
| M2-003 | 测试编写 | 测试 |
| M3-001 | 桌面端服务开发 | 后端 |
| M3-002 | 桌面端服务开发 | 后端 |
| M3-003 | UI布局和开发 | 前端 |
| M3-004 | UI布局和开发 | 前端 |
| M3-005 | 测试编写 | 测试 |
| M4-001 | 桌面端服务开发 | 后端 |
| M4-002 | 桌面端服务开发 | 后端 |
| M4-003 | UI布局和开发 | 前端 |
| M4-004 | 前端组件开发 | 前端 |
| M4-005 | 前端组件开发 | 前端 |
| M4-006 | 测试编写 | 测试 |
| M5-001 | 桌面端服务开发 | 后端 |
| M5-002 | 后端API开发 | 后端 |
| M5-003 | 前端组件开发 | 前端 |
| M5-004 | 测试编写 | 测试 |
| M6-001 | 部署打包 | 后端 |
| M6-002 | 部署打包 | 后端 |
| M6-003 | 部署打包 | 前端 |
| M6-004 | 测试编写 | 测试 |
| M6-005 | E2E测试 | 测试 |
| M7-001 | 桌面端服务开发 | 后端 |
| M7-002 | 桌面端服务开发 | 后端 |
| M7-003 | 前端组件开发 | 前端 |
| M7-004 | UI布局和开发 | 前端 |
| M7-005 | 前端组件开发 | 前端 |
| M7-006 | 测试编写 | 测试 |
| M8-001 | 后端API开发 | 后端 |
| M8-002 | 后端API开发 | 后端 |
| M8-003 | UI布局和开发 | 前端 |
| M8-004 | 前端组件开发 | 前端 |
| M8-005 | 测试编写 | 测试 |

---

## 4. 提示词组装规则

### 组成关系

- **模板骨架是「壳」**：提供 tmux 执行协议、前置文档引用、编码规范、验收标准格式、结果报告路径
- **任务文件是「内容」**：填充差异段落（概述、功能需求、代码骨架、验证命令）

### 组装方式

Agent 在执行时自行拼接，不需要物理合并文件：

1. 读取对应模板文件 → 获取骨架结构
2. 读取任务文件 → 获取差异内容
3. 合并：模板的通用段落 + 任务文件的差异段落 = 完整执行提示词

### 不需要物理合并

任务文件中已删除 tmux 执行协议段和重复的编码规范段，这些由模板提供。Agent 在执行时按需加载。

---

## 5. 前端任务 UI/UX 文档加载规则

### 通用加载（所有前端任务）

- `docs/05-设计-UI.md` — 设计系统摘要
- `docs/设计-Apple风格.md` — Apple 风格设计令牌
- `docs/设计-UX-错误处理.md` — 错误状态处理规范

### UI布局和开发任务（页面级）

按任务文件中声明的前置文档列表加载，关注布局网格、导航、路由结构。

| 任务 | UI 设计文档 | UX 交互文档 | API 契约 |
|------|-----------|-----------|---------|
| M3-003 | `设计-UI-初始化向导.md` | `设计-UX-用户旅程.md` §2.1, §2.2 + `设计-UX-操作流程.md` §4.1, §4.5 | `09-API契约.md` §5, §9.12~§9.14 |
| M3-004 | `设计-UI-认证.md` | `设计-UX-用户旅程.md` §2.3 + `设计-UX-操作流程.md` §4.2 | `09-API契约.md` §9.1, §9.2 |
| M4-003 | `设计-UI-主界面.md` | `设计-UX-交互模式.md` + `设计-UX-操作流程.md` §4.3 | `09-API契约.md` §9.3 |
| M7-004 | `设计-UI-分类管理.md` | `设计-UX-交互模式.md` §3.4 | `09-API契约.md` §9.8~§9.11 |
| M8-003 | `设计-UI-其他.md` | `设计-UX-用户旅程.md` §2.5 + `设计-UX-操作流程.md` §4.6 | `09-API契约.md` §9.20 |

### 前端组件开发任务（组件级）

按任务文件中声明的前置文档列表加载，关注交互模式、表单验证、状态管理。

| 任务 | UI 设计文档 | UX 交互文档 | API 契约 |
|------|-----------|-----------|---------|
| M2-002 | `设计-UI-初始化向导.md` | `设计-UX-用户旅程.md` §2.1, §2.2 + `设计-UX-操作流程.md` §4.1 | `09-API契约.md` §5 |
| M4-004 | `设计-UI-主界面.md` | `设计-UX-交互模式.md` + `设计-UX-操作流程.md` §4.3 | `09-API契约.md` §9.4, §9.5 |
| M4-005 | `设计-UI-主界面.md` | `设计-UX-交互模式.md` + `设计-UX-操作流程.md` §4.3 | `09-API契约.md` §9.7 |
| M5-003 | `设计-UI-状态组件.md` | `设计-UX-交互模式.md` §3.5, §3.8 | `09-API契约.md` §6, §9.17 |
| M7-003 | `设计-UI-主界面.md` | `设计-UX-交互模式.md` + `设计-UX-操作流程.md` §4.3 | — |
| M7-005 | `设计-UI-认证.md` | `设计-UX-操作流程.md` §4.2 | `09-API契约.md` §9.16 |
| M8-004 | `设计-UI-其他.md` | `设计-UX-用户旅程.md` §2.5 + `设计-UX-操作流程.md` §4.6 | — |

---

## 6. 执行流程

1. `项目` pane 确认任务 → 查 §3 映射表选择对应模板
2. 通过 `scripts/tmux-send-prompt.sh` 发送提示词到目标 pane
3. 目标 pane 的 Agent 读取模板 + 任务文件（§4 组装规则）
4. **前端任务**：Agent 额外读取 §5 中对应的 UI/UX 设计文档
5. 执行任务 → 写入结果到 `/workspace/tasks/result/{{任务编号}}.md`
6. `项目` pane 确认结果

---

## 7. 并行执行约束

- 同一文件只允许一个 Agent 修改
- 后端改 `apps/server/`，桌面端改 `apps/desktop/src/`，前端改 `apps/desktop/frontend/`
- 测试可改两侧 `tests/`
- 里程碑内并行组参考编排索引 §5

---

## 8. 完成报告机制

任务完成后，将产出物清单写入 `/workspace/tasks/result/{{任务编号}}.md`，格式参照 `tasks/任务执行结果模板.md`。

### 文件锁规则

- 任务开始时创建空文件作为锁
- 完成时写入完整内容
- 一次只能被一个任务编写

---

## 版本历史

- v1.0.0 (2026-04-18): 初始版本