team/tasks/任务提示词模板-桌面端服务开发.md

{{任务编号}} 桌面端任务：{{任务标题}}

概述

{{一段描述：服务目标、纯本地服务说明}}

前置依赖: {{依赖任务列表}}

tmux 执行协议

• Session: arno-team，始终复用 项目 / 后端 / 前端 / 测试 四个 pane，禁止新建 tmux session / window / pane
• 环境重置: 开始前确保目标 pane 中是新启动的 cc 环境（/exit 后重启，清除遗留上下文）
• 分发方式: 由 项目 pane 发送简短提示词，让目标 pane 自行读取任务文件

前置文档（必读）

执行本任务前必须加载以下文档，作为接口和存储规范。

接口与架构规范（所有桌面端任务通用）

• docs/09-API契约.md — 客户端本地接口定义（桌面端需遵守请求/响应格式）
  • §1 通用规范 | §2 通用响应格式 | §4 错误码规范
  • §9 客户端本地接口（HTTPS IPC）：§9.1~§9.20 全部端点
• docs/07-系统架构.md §2.1（客户端架构）| §4（CRDT 同步架构）| §5（数据流）

数据库规范（所有桌面端任务通用）

• docs/08-数据库设计.md §3（客户端本地数据库）
  • §3.3 索引设计 | §3.5 SQLite DDL 参考
  • §4 数据版本迁移策略（§4.2 迁移脚本规范）

工程规范（所有桌面端任务通用）

• docs/11-工程规范.md §1.5（术语使用规范）| §2（编码规范）

按任务选取

任务	API 契约章节	数据库章节	其他参考
M3-001	§9.12 证书状态、§9.13 导出、§9.14 导入	§3.2.5 SyncMeta	—
M3-002	§9.1 登录、§9.2 锁定、§9.15 修改密码、§9.16 密码恢复	§3.2.7 LocalConfig
M4-001	无直接 API（纯本地服务）	无直接表操作	—
M4-002	§9.3~§9.7 接口、§9.8~§9.11 分类接口	§3.2.1、§3.2.3、§3.2.4、§3.2.6
M5-001	§6 同步接口（push/pull 格式参考）	§3.2.3 CRDTEntry、§3.2.5 SyncMeta	docs/07-系统架构.md §4（CRDT 同步架构）
M7-001	§9.8~§9.11 分类接口	§3.2.2 Category
M7-002	§9.16 POST /api/v1/local/password/recover	§3.2.7 LocalConfig	—

功能需求（FR-NNN ~ FR-NNN）

• {{需求条目}}

需要创建的文件

1. src/{{module_name}}/services/{{service}}.py — {{服务名}}

{{类/方法骨架}}

2. 其他文件

{{附加文件}}

编码规范

• Python 3.12+，mypy strict，禁止 Any
• ruff format/check，Google 风格 docstring

验收标准

• {{逐条检查}}
• 模块测试覆盖率 >{{阈值}}%

验证命令

{{具体命令}}

完成后将产出物清单写入 /workspace/tasks/result/{{任务编号}}.md。