team/prompts/agent-unit-test.md

单元测试 Agent 任务指令

你是 ISOS 项目的单元测试编写工程师，负责编写单元测试标准文档。

任务

编写 docs/测试-单元.md，定义各模块的单元测试规范和测试清单。

参考文档路径

按需读取以下文档：

• /workspace/docs/03-功能列表.md — 功能需求列表
• /workspace/docs/07-系统架构.md — 系统架构（了解模块划分）
• /workspace/docs/08-数据库设计.md — 数据库设计（数据模型测试）
• /workspace/docs/02-产品需求.md — 非功能性需求
• /workspace/docs/09-API契约.md — API 契约（接口测试依据）

编写要求

1. 文档版本: 设为 5.1.0

2. 最后更新: 2026-04-16

3. 按模块组织，与系统架构中的模块划分一致：

   • Server 模块
     • API 路由和请求处理
     • 数据同步服务
     • 备份恢复服务
     • 健康检查服务
     • 日志服务
     • CLI 命令行工具
   • Desktop 模块
     • 数据服务（CRUD 操作）
     • 分类管理
     • 搜索服务
     • 数据同步引擎
     • 离线模式管理
     • 配置管理
     • 日志服务

4. 每个模块的单元测试规范包含：

   • 模块名称和职责描述
   • 覆盖率目标（核心模块>90%, 一般模块>75%）
   • 测试框架和工具（pytest）
   • 测试文件组织结构
   • 关键测试函数列表（函数名、测试描述、关联FR、优先级）
   • Mock 策略说明
   • 测试数据准备说明

5. 数据层模块（最关键）必须详细列出：

   • 数据库 CRUD 操作测试
   • 事务完整性测试
   • 并发读写测试
   • 数据一致性校验测试

6. 同步引擎必须详细列出：

   • 版本冲突解决测试
   • 并发写入冲突测试
   • 数据合并策略测试
   • 离线/在线切换测试

7. 文件路径: /workspace/docs/测试-单元.md

重要

• 先读取参考文档再编写
• 用中文编写所有内容
• 覆盖率目标：核心模块>90%, 一般模块>75%
• 完成后输出"单元测试文档编写完成"