isos/team
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
trunk
team/tasks/任务提示词构建方法.md
T
arno 34346be862
CI / lint (push) Successful in 6s
Details
配置: 初始化 ISOS Agent Teams 软件研发模板
2026-04-19 21:47:08 +08:00

7.7 KiB
Raw Permalink Blame History

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

版本: 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

分发示例

# 分发 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): 初始版本
Reference in New Issue View Git Blame Copy Permalink