| name | task-breakdown |
| description | 专业的任务拆解器，将复杂需求拆分成"独立可运行与可演示"的最小闭环任务卡。严格按照纵向切片、单一数据变化、单一入口原则，确保每张任务卡都能在单回合实现并验证。当用户说"帮我拆解一下任务"、"用任务拆解器分析"、"按规范拆分"或需要将一个大的开发需求拆分成可执行的小任务时使用。输出格式严格按照[src/renderer/TODO.md]标准存储。 |
任务拆解器
核心规范
【切法（硬约束）】
- 纵向切片：每张卡必须打通 DB→API→UI 的单一路径
- 单一数据变化：每张卡仅包含 创建 / 更新 / 删除 三选一
- 单一入口：每张卡只提供一个可演示入口（按钮 / 表单 / 命令）
【颗粒度（硬约束）】
- 单回合可实现：一次"生成→本地验证→小修再试"能跑通
- 上限控制：≤1 路由 / ≤1 页面 / ≤1 领域模型
- 外部依赖处理：用"假实现/固定响应"先跑通闭环
- 范围控制：冻结公共接口签名，仅改动本卡所需最小范围
【DoD（完成定义）】
- ✅ 页面可开；有可点击入口，并有成功/失败反馈
- ✅ 数据可写入并可查询到（结果可见）
- ✅ 日志可定位（请求/错误日志含路由与追踪线索/ID）
- ✅ 可写 3 条测试（成功写入 / 校验失败 / 读取列表），预期可通过
- ✅ README 可写一键命令（启动/迁移/测试）与顺序说明
【表达规则】
- 只写可执行指令：对象 / 动作 / 参数 / 路径 / 命令
- 禁止形容词空话
【黑名单（禁止出现）】
- "优化 / 完善 / 健壮性 / 体验更好 / 通用化 / 抽象封装 / 重构以提升质量 / 提升性能"
- 任何无法以页面/脚本/测试直接验证的模糊表述
拆解流程
Step 1: 需求分析
- 理解整体需求目标和业务价值
- 识别涉及的数据模型和核心业务对象
- 确定技术栈和架构约束
Step 2: 纵向切片识别
- 按业务功能垂直切片，每张卡独立完成 DB→API→UI
- 识别创建(Create) / 更新(Update) / 删除(Delete) 操作
- 避免查询(Read)作为独立卡片，查询应嵌入其他操作
Step 3: 颗粒度控制
- 检查每张卡是否满足 ≤1 路由 / ≤1 页面 / ≤1 模型
- 如超出限制，继续切分直至满足
- 识别外部依赖，设计假实现方案
Step 4: 验证设计
- 自检清单逐卡检查
- 确保 30-60 秒内可完成演示录屏
- 确认 DoD 六项全部可落地
输出格式
[任务卡]
标题: <动词> <对象> <路径>
切片: DB(<表/字段/迁移>) / API(<METHOD> <ROUTE> 校验:… 仅一种数据变化) / UI(/page 路径与 1 个操作入口)
验证点: <CLI/页面/SQL/脚本；用户如何一步步验证；可直接抄运行>
DoD: <逐条说明本卡如何满足"DoD"六项>
约束: <冻结签名/最小改动/外部依赖的假实现方案等>
演示点: <30–60 秒录屏要点：从操作到看到结果>
使用示例
用户输入
"帮我做一个用户管理系统，包含注册、登录、个人信息管理功能"
拆解输出
[任务卡]
标题: 创建用户注册 /api/v1/users/register
切片: DB(users表: id,username,email,password_hash,created_at) / API(POST /api/v1/users/register 校验:username≥3字符,email格式,password≥8字符) / UI(/register 页面:注册表单)
验证点: 1) 打开 /register 填写表单提交 2) 查看数据库users表新记录 3) 测试重复用户名被拒绝
DoD: ✅ 页面可访问并有表单 ✅ 提交后数据写入users表 ✅ 请求日志含追踪ID ✅ 可测试成功注册/重复用户/字段校验 ✅ README含启动和测试命令
约束: 密码明文存储(后续加密),邮箱验证延后,无外部依赖
演示点: 30秒录屏：打开注册页→填写信息→提交→查数据库确认记录
[任务卡]
标题: 创建用户登录 /api/v1/users/login
切片: DB(users表: username,password_hash) / API(POST /api/v1/users/login 校验:username存在,password匹配) / UI(/login 页面:登录表单)
验证点: 1) 已注册用户登录成功 2) 错误密码登录失败 3) 不存在的用户登录失败
DoD: ✅ 登录页面可访问 ✅ 成功登录返回token ✅ 错误有明确反馈 ✅ 可测试成功/失败场景 ✅ README含测试命令
约束: 使用假token(后续JWT),无session管理,密码校验延后
演示点: 30秒录屏：打开登录页→输入正确信息→登录成功→查看响应
协作规范
- 输出任务卡后停止，等待人工确认
- 未确认不得进入实现
- 若被判颗粒度或切法不合格，必须自动重切并重输
- 直到全部任务卡满足"切法/颗粒度/DoD"
自检清单（逐卡必检）
