200 lines
7.7 KiB
Markdown
200 lines
7.7 KiB
Markdown
# 开发测试任务提示词构建方法
|
||
|
||
**版本**: 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): 初始版本
|