AgentSkillsCN

task-breakdown

专业的任务拆解器，将复杂需求拆分成"独立可运行与可演示"的最小闭环任务卡。严格按照纵向切片、单一数据变化、单一入口原则，确保每张任务卡都能在单回合实现并验证。当用户说"帮我拆解一下任务"、"用任务拆解器分析"、"按规范拆分"或需要将一个大的开发需求拆分成可执行的小任务时使用。输出格式严格按照[src/renderer/TODO.md]标准存储。

中文原作
SKILL.md
--- frontmatter
name: task-breakdown
description: 专业的任务拆解器，将复杂需求拆分成"独立可运行与可演示"的最小闭环任务卡。严格按照纵向切片、单一数据变化、单一入口原则，确保每张任务卡都能在单回合实现并验证。当用户说"帮我拆解一下任务"、"用任务拆解器分析"、"按规范拆分"或需要将一个大的开发需求拆分成可执行的小任务时使用。输出格式严格按照[src/renderer/TODO.md]标准存储。

任务拆解器

核心规范

【切法（硬约束）】

  • •纵向切片：每张卡必须打通 DB→API→UI 的单一路径
  • •单一数据变化：每张卡仅包含 创建 / 更新 / 删除 三选一
  • •单一入口：每张卡只提供一个可演示入口（按钮 / 表单 / 命令）

【颗粒度（硬约束）】

  • •单回合可实现：一次"生成→本地验证→小修再试"能跑通
  • •上限控制：≤1 路由 / ≤1 页面 / ≤1 领域模型
  • •外部依赖处理：用"假实现/固定响应"先跑通闭环
  • •范围控制：冻结公共接口签名，仅改动本卡所需最小范围

【DoD（完成定义）】

  1. •✅ 页面可开；有可点击入口，并有成功/失败反馈
  2. •✅ 数据可写入并可查询到（结果可见）
  3. •✅ 日志可定位（请求/错误日志含路由与追踪线索/ID）
  4. •✅ 可写 3 条测试（成功写入 / 校验失败 / 读取列表），预期可通过
  5. •✅ README 可写一键命令（启动/迁移/测试）与顺序说明

【表达规则】

  • •只写可执行指令：对象 / 动作 / 参数 / 路径 / 命令
  • •禁止形容词空话

【黑名单（禁止出现）】

  • •"优化 / 完善 / 健壮性 / 体验更好 / 通用化 / 抽象封装 / 重构以提升质量 / 提升性能"
  • •任何无法以页面/脚本/测试直接验证的模糊表述

拆解流程

Step 1: 需求分析

  1. •理解整体需求目标和业务价值
  2. •识别涉及的数据模型和核心业务对象
  3. •确定技术栈和架构约束

Step 2: 纵向切片识别

  1. •按业务功能垂直切片，每张卡独立完成 DB→API→UI
  2. •识别创建(Create) / 更新(Update) / 删除(Delete) 操作
  3. •避免查询(Read)作为独立卡片，查询应嵌入其他操作

Step 3: 颗粒度控制

  1. •检查每张卡是否满足 ≤1 路由 / ≤1 页面 / ≤1 模型
  2. •如超出限制，继续切分直至满足
  3. •识别外部依赖，设计假实现方案

Step 4: 验证设计

  1. •自检清单逐卡检查
  2. •确保 30-60 秒内可完成演示录屏
  3. •确认 DoD 六项全部可落地

输出格式

code
[任务卡]
标题: <动词> <对象> <路径>
切片: DB(<表/字段/迁移>) / API(<METHOD> <ROUTE> 校验:… 仅一种数据变化) / UI(/page 路径与 1 个操作入口)
验证点: <CLI/页面/SQL/脚本；用户如何一步步验证；可直接抄运行>
DoD: <逐条说明本卡如何满足"DoD"六项>
约束: <冻结签名/最小改动/外部依赖的假实现方案等>
演示点: <30–60 秒录屏要点：从操作到看到结果>

使用示例

用户输入

"帮我做一个用户管理系统，包含注册、登录、个人信息管理功能"

拆解输出

code
[任务卡]
标题: 创建用户注册 /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秒录屏：打开登录页→输入正确信息→登录成功→查看响应

协作规范

  1. •输出任务卡后停止，等待人工确认
  2. •未确认不得进入实现
  3. •若被判颗粒度或切法不合格，必须自动重切并重输
  4. •直到全部任务卡满足"切法/颗粒度/DoD"

自检清单（逐卡必检）

  • • 是否 DB→API→UI 贯通？是否仅 1 个入口、1 种数据变化？
  • • 是否 ≤1 路由 / ≤1 页面 / ≤1 模型？若否，是否已经继续切小？
  • • 是否能在 30–60 秒内录屏完成演示？
  • • DoD 六项是否都能在本卡落地（并能写进 README/测试）？
  • • 是否先打通闭环，把校验/边界/样式放到后续卡？
  • • 是否完全没有黑名单词？