配置: 初始化 ISOS Agent Teams 软件研发模板

tasks/任务提示词模板-后端API开发.md

@@ -0,0 +1,76 @@
+# {{任务编号}} 后端任务：{{任务标题}}
+
+## 概述
+
+{{一段描述：API 目标}}
+
+**前置依赖**: {{依赖任务列表}}
+
+## tmux 执行协议
+
+- **Session**: `arno-team`，始终复用 `项目` / `后端` / `前端` / `测试` 四个 pane，禁止新建 tmux session / window / pane
+- **环境重置**: 开始前确保目标 pane 中是新启动的 `cc` 环境（/exit 后重启，清除遗留上下文）
+- **分发方式**: 由 `项目` pane 发送简短提示词，让目标 pane 自行读取任务文件
+
+## 前置文档（必读）
+
+> 执行本任务前必须加载以下文档，作为接口和存储规范。
+
+### 接口与架构规范（所有后端任务通用）
+- `docs/09-API契约.md` — 完整 REST API 定义（所有后端任务必须严格遵守）
+  - §1 通用规范（认证方式）| §2 通用响应格式 | §3 HTTP 状态码 | §4 错误码规范
+- `docs/07-系统架构.md` §2.2（服务端架构）| §7（模块划分）
+
+### 数据库规范（所有后端任务通用）
+- `docs/08-数据库设计.md` §2（服务端数据库）
+  - §2.3 索引设计 | §2.5 SQLite DDL 参考
+  - §4 数据版本迁移策略（§4.2 迁移脚本规范、§4.3 迁移执行流程）
+
+### 工程规范（所有后端任务通用）
+- `docs/11-工程规范.md` §1.5（术语使用规范）| §2（编码规范）| §5（API 设计规范）
+
+### 按任务选取
+| 任务 | API 契约章节 | 数据库章节 |
+|------|-------------|-----------|
+| M2-001 | §5（设备注册接口）§7（管理接口 §7.1~§7.5） | §2.2.1 |
+| M5-002 | §6（同步接口 §6.1~§6.3） | §2.2.2 |
+| M8-001 | §7.8 GET /api/v1/admin/logs | §2.2.3 |
+| M8-002 | §7.6 POST /api/v1/admin/backups、§7.7 恢复备份 | §2.2.4 |
+
+## 功能需求（FR-NNN ~ FR-NNN）
+
+- {{需求条目列表}}
+
+## 需要创建的文件
+
+### 1. `src/{{module_name}}/services/{{service}}.py` — {{服务名}}
+
+{{类/方法骨架 + 参数说明 + 约束}}
+
+### 2. `src/{{module_name}}/api/routes/{{route}}.py` — API 路由
+
+{{端点定义}}
+
+### 3. `src/{{module_name}}/db/migrations/{{NNNN}}_{{name}}.sql` — 数据库迁移
+
+{{DDL}}
+
+## 编码规范
+
+- Python 3.12+，完整类型注解（mypy strict）
+- ruff format/check，Google 风格 docstring
+- 严格遵守 `docs/09-API契约.md`
+
+## 验收标准
+
+- {{逐条检查}}
+- mypy --strict 零错误
+- ruff check 零告警
+
+## 验证命令
+
+```bash
+{{具体命令}}
+```
+
+完成后将产出物清单写入 `/workspace/tasks/result/{{任务编号}}.md`。