--- 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>.md` - `02-<并行任务B>.md` - `03-<串行任务C>.md` ## 最小检查清单 1. [ ] 是否确认已阅读完所有相关文档? 2. [ ] 是否在 `docs/project` 下新建了本次专属文件夹? 3. [ ] 是否产出 `00-总览.md`(或等价总览文件)? 4. [ ] 是否将可并行任务拆分为不同 md 文件? 5. [ ] 是否所有 md 文件都带有连续序号? 6. [ ] 并行任务是否为每个任务文件补充了 Touch List/共享文件策略/编译绿线策略? 7. [ ] 子任务完成后,是否在对应版本的 `00-任务总览.md` 标注“已完成”,并在“待验证表”里更新状态?