ShaoHua
7a4c516a20
- 后端：新增 CloudSync 认证/权限/端点/服务与 DTO - 数据：新增用户/会话/安全策略实体与 EF Core migrations - 前端：新增云同步设置 UI、客户端与本地存储；Vite 支持 maui 构建输出到 wwwroot - 桌面端：新增 Avalonia 项目、内置 WebServer、托盘与 Windows 全局热键 - 发布/构建：新增 Windows/Linux 发布脚本与统一入口；调整 MAUI 资源与安装包配置 - 文档：同步更新 README/docs 与协作规则
2.8 KiB
2.8 KiB
alwaysApply
| alwaysApply |
|---|
| false |
任务拆分输出规范（必须遵守）
适用时机
- 当需求需要先通读项目/产品/技术文档再开始实现时，必须先输出任务拆分文档，再开始写代码或改配置。
输出要求
- 先读完所有相关文档：包括但不限于
docs/、docs/project/下与本次需求相关的内容。 - 先写任务拆分，再动手实现：任务拆分产出是后续执行的入口与对齐依据。
- 新增一个专属文件夹：在
d:\Proj\6.Hua.Todo\docs\project下新建一个文件夹存放本次任务拆分文档。- 文件夹命名建议：
任务拆分-<主题>-<日期或版本>（保持可检索、避免与既有文档冲突）。
- 文件夹命名建议：
- 可并行的任务要拆成不同 md：能同步执行（相互无依赖/弱依赖）的任务，必须拆到不同的 Markdown 文件中，便于并行推进与分工。
- 文件必须带序号：同一文件夹下的 md 文件按执行顺序编号，序号从小到大。
- 文件名建议：
01-xxx.md、02-xxx.md、03-xxx.md。
- 文件名建议：
- 每个任务文件至少包含：
- 目标/范围（做什么、不做什么）
- 前置条件（依赖哪些结论/接口/文档）
- 验收标准（怎么判断完成，包含可执行的验证点）
- 风险与回滚（如有）
- 子任务完成后的标记要求：
- 当任一子任务（例如
01-*/02-*/03-*）完成实现后，必须在对应版本的00-任务总览.md中同步标注“已完成”。 - 同时必须维护一张“待验证表”（可用 Markdown 表格），对每个子任务给出“待验证/已验证”状态，避免实现完成但验收未闭环。
- 当任一子任务（例如
- 并行冲突规避要求：当任务会被分发到多个 solo 窗口并行推进时，每个任务文件必须额外包含：
- 触碰文件清单（Touch List，精确到文件）
- 共享文件策略（哪些是共享文件、唯一 Writer 是谁、如何与集成窗口对接）
- 编译绿线策略（如何确保阶段性交付不破坏编译）
推荐结构（模板）
00-总览.md- 背景与目标
- 关键决策与约束
- 并行分组说明（哪些文件可同步做）
01-<并行任务A>.md02-<并行任务B>.md03-<串行任务C>.md
最小检查清单
- 是否确认已阅读完所有相关文档？
- 是否在
docs/project下新建了本次专属文件夹？ - 是否产出
00-总览.md（或等价总览文件）？ - 是否将可并行任务拆分为不同 md 文件？
- 是否所有 md 文件都带有连续序号？
- 并行任务是否为每个任务文件补充了 Touch List/共享文件策略/编译绿线策略？
- 子任务完成后，是否在对应版本的
00-任务总览.md标注“已完成”，并在“待验证表”里更新状态？