kanfu-panda 任务管理
管理功能开发任务的拆解、分配与进度追踪。支持从 PRD 自动拆解任务、标记任务状态。
子命令解析
从 $ARGUMENTS 中解析子命令和参数：
| 子命令 | 格式 | 说明 |
|---|---|---|
plan <功能名或功能ID> |
从 PRD 自动拆解任务列表 | |
list [功能名或功能ID] |
查看任务状态（不传则查看全部未完成任务） | |
start <任务ID> |
标记任务为进行中 | |
done <任务ID> |
标记任务为已完成 | |
blocked <任务ID> <原因> |
标记任务为阻塞，记录阻塞原因 | |
reopen <任务ID> |
重新打开任务（撤销 done/blocked） |
如果未提供子命令或子命令无法识别，输出以上帮助信息后停止。
任务 ID 与文件约定
任务 ID 格式
T<功能ID的日期-时分秒>-<NN>-<类型>
<功能ID的日期-时分秒>：所属功能ID去掉F前缀的部分（功能F20260718-094301→ 前缀20260718-094301）。嵌入 feature 的唯一时分秒，使任务号全局唯一且自带归属（一眼看出属哪个 feature）NN：本功能内两位递增序号（每 feature 从01起）- 类型：
feat— 功能代码实现test— 测试编写doc— 文档输出infra— 基础设施/脚手架design— 设计产出
示例：功能 F20260718-094301 的任务 → T20260718-094301-01-feat、T20260718-094301-02-test
为什么 T 用「功能ID时分秒前缀 + 本地序号」而非每个任务自取时分秒：任务在拆解时成批同秒创建，若各自取独立时分秒会互相撞号。改用「所属功能的时分秒前缀 + 本功能内序号」后：既全局唯一（继承功能ID的唯一性）、又自带归属（看得出属哪个 feature）、还并行安全（不同 feature 前缀不同，同批任务靠序号区分）。任务号收敛在唯一命名的 feature 任务文件内，不跨 feature 冲突。
任务清单文件路径
docs/06_tasks/<功能ID>-<功能名>-tasks.md
示例：docs/06_tasks/F20260406-093000-user-auth-tasks.md
若功能ID未知（如独立任务），使用：docs/06_tasks/YYYYMMDD-<关键词>-tasks.md
任务清单文档格式
<!-- PDLC-TASKS -->
<!-- 功能ID: F20260406-093000 -->
<!-- 功能名称: user-auth -->
<!-- 关联PRD: docs/01_requirements/prd/F20260406-093000-user-auth-prd.md -->
<!-- 最后更新: 2026-04-06 -->
# 任务清单：user-auth（F20260406-093000）
## 总览
- 总任务数：N
- 待开始：N | 进行中：N | 已完成：N | 阻塞：N
## 任务列表
> 下例为功能 `F20260406-093000`（user-auth）的任务清单——任务ID 前缀 `20260406-093000` 即该功能ID的时分秒段，`NN` 在本功能内递增。
| 任务ID | 类型 | 描述 | 状态 | 估时 | 截止日期 | 关联文档 | 备注 |
|--------|------|------|------|------|---------|---------|------|
| T20260406-093000-01-design | design | 创建 API 设计文档 | ⬜ 待开始 | 2h | 2026-04-07 | - | - |
| T20260406-093000-02-design | design | 创建数据库设计文档 | ⬜ 待开始 | 1h | 2026-04-07 | - | - |
| T20260406-093000-03-infra | infra | 生成代码脚手架 | ⬜ 待开始 | 0.5h | 2026-04-07 | - | - |
| T20260406-093000-04-test | test | 编写单元测试 | ⬜ 待开始 | 3h | 2026-04-08 | - | - |
| T20260406-093000-05-feat | feat | 实现注册接口 | ⬜ 待开始 | 4h | 2026-04-09 | - | - |
| T20260406-093000-06-feat | feat | 实现登录接口 | ⬜ 待开始 | 2h | 2026-04-09 | - | - |
| T20260406-093000-07-test | test | 运行测试确认绿灯 | ⬜ 待开始 | 1h | 2026-04-10 | - | - |
| T20260406-093000-08-doc | doc | 创建评审记录 | ⬜ 待开始 | 1h | 2026-04-10 | - | - |
## 阻塞记录
| 任务ID | 阻塞原因 | 记录时间 | 解除时间 |
|--------|---------|---------|---------|
| （暂无） | - | - | - |
状态图标约定：
⬜ 待开始🔄 进行中✅ 已完成🚫 阻塞
子命令执行流程
plan <功能名或功能ID>
前置检查：
- 从用户输入中提取功能名称关键词或功能ID
- 在
docs/01_requirements/prd/目录下搜索对应 PRD 文档 - 未找到 PRD → 输出以下信息后立即停止，不继续执行：
⛔ PDLC 守卫：未找到与「<功能名>」相关的 PRD 文档。 任务拆解必须基于已有的 PRD。请先运行： 👉 /pdlc-prd <需求描述> - 找到 → 提取功能ID，读取 PRD 内容，继续执行
执行流程：
- 读取 PRD 文档，分析功能范围、用户故事和验收标准
- 同时检查
docs/02_design/下是否存在相关设计文档，有则一并读取 - 扫描本功能的任务文件（
docs/06_tasks/<功能ID>-*-tasks.md），取其中已有任务的最大序号 +1（不跨 feature 扫描）——每 feature 独立编号，并行开发不同 feature 时任务号互不干扰、合并零冲突 - 按 PDLC 阶段顺序拆解任务：
- 设计任务（design）：需要产出的每份设计文档各一个任务
- 基础设施任务（infra）：目录初始化、脚手架生成
- 测试任务（test）：测试计划编写、测试代码编写
- 功能实现任务（feat）：每个独立接口/页面/模块各一个任务，粒度不超过半天工作量
- 文档任务（doc）：评审记录、CHANGELOG 更新
- 为每个任务估算工时（0.5h 为最小单位）
- 根据估时和 PDLC 阶段依赖关系，自动推算每个任务的截止日期：
- 从今日日期开始，按阶段顺序排列（设计 → 基础设施 → 测试 → 功能实现 → 文档）
- 同阶段内的任务可并行，截止日期相同
- 下一阶段的开始日期 = 上一阶段截止日期的下一个工作日
- 每日按 8h 工作量计算，超出的顺延到下一工作日
- 在
docs/06_tasks/下创建任务清单文档 - 输出任务总览表格（含预计完成时间线）
list [功能名或功能ID]
- 有参数：在
docs/06_tasks/下查找对应功能的任务文件，输出该功能任务详情 - 无参数：扫描
docs/06_tasks/下所有任务文件，汇总非已完成任务，按状态分组输出：- ⏰ 已逾期（截止日期早于今日且未完成的任务，最先展示）
- 🔄 进行中
- 🚫 阻塞（含阻塞原因）
- ⬜ 待开始（按功能ID分组，仅展示最近 3 个功能）
- 输出末尾追加整体完成率统计：
完成率: X/N (XX%) - 若存在逾期任务，额外输出警告：
⚠️ 有 N 个任务已逾期，请及时处理
start <任务ID>
- 在
docs/06_tasks/下扫描所有任务文件，找到包含该任务ID的文件 - 未找到 → 提示任务ID不存在后停止
- 找到 → 将该任务状态从
⬜ 待开始/🚫 阻塞更新为🔄 进行中 - 更新文件顶部的总览计数
- 更新文件顶部的
最后更新时间 - 输出确认消息：
✓ 任务 <任务ID> 已标记为进行中
done <任务ID>
- 在
docs/06_tasks/下扫描所有任务文件，找到包含该任务ID的文件 - 未找到 → 提示任务ID不存在后停止
- 找到 → 将该任务状态更新为
✅ 已完成，在备注列填入完成时间 - 更新文件顶部的总览计数和
最后更新时间 - 输出确认消息：
✓ 任务 <任务ID> 已完成 - 若该功能所有任务均已完成，额外输出：
🎉 功能 <功能ID> 全部任务已完成！
blocked <任务ID> <原因>
- 在
docs/06_tasks/下找到包含该任务ID的文件 - 未找到 → 提示任务ID不存在后停止
- 找到 → 将该任务状态更新为
🚫 阻塞，在备注列填入原因摘要 - 在文档末尾的"阻塞记录"表格追加一行（任务ID、原因、当前时间）
- 更新文件顶部的总览计数和
最后更新时间 - 输出确认消息：
⚠️ 任务 <任务ID> 已标记为阻塞：<原因>
reopen <任务ID>
- 找到包含该任务ID的文件
- 未找到 → 提示任务ID不存在后停止
- 找到 → 将该任务状态更新为
⬜ 待开始，清空备注列 - 若阻塞记录表格中有该任务，填入当前时间作为解除时间
- 更新总览计数和
最后更新时间 - 输出确认消息：
✓ 任务 <任务ID> 已重新打开
与 pdlc-status 联动
运行 pdlc-status 时，若 docs/06_tasks/ 目录存在，自动在输出末尾追加：
## 任务进度
| 功能 | 总计 | 完成 | 进行中 | 阻塞 | 完成率 |
|------|------|------|--------|------|--------|
| F20260406-093000 user-auth | 8 | 5 | 1 | 0 | 62% |
$ARGUMENTS