pdlc-task git:20260507.ba956b7A

Immutable. This exact content is served forever at /api/v1/blob/9f93287c869ff494.

---
name: pdlc-task
description: 阶段内任务跟踪（创建/更新任务列表，附在工作流上）
argument-hint: <功能ID | 任务描述>
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
layer: 2
stage: task
produces:
  - docs/06_tasks/<feature-id>-tasks.md
requires: []
next_step: null
terminal_state: null
---

# 任务管理

<!-- @include templates/prompts/iron-law.md -->

管理功能开发任务的拆解、分配与进度追踪。支持从 PRD 自动拆解任务、标记任务状态。

## 子命令解析

从 `$ARGUMENTS` 中解析子命令和参数：

| 子命令 | 格式 | 说明 |
|--------|------|------|
| `plan <功能名或功能ID>` | 从 PRD 自动拆解任务列表 |
| `list [功能名或功能ID]` | 查看任务状态（不传则查看全部未完成任务） |
| `start <任务ID>` | 标记任务为进行中 |
| `done <任务ID>` | 标记任务为已完成 |
| `blocked <任务ID> <原因>` | 标记任务为阻塞，记录阻塞原因 |
| `reopen <任务ID>` | 重新打开任务（撤销 done/blocked） |

如果未提供子命令或子命令无法识别，输出以上帮助信息后停止。

---

## 任务 ID 与文件约定

### 任务 ID 格式

`T<YYYYMMDD>-<NN>-<类型>`

- `YYYYMMDD`：任务拆解日期
- `NN`：当日两位递增序号
- 类型：
  - `feat` — 功能代码实现
  - `test` — 测试编写
  - `doc` — 文档输出
  - `infra` — 基础设施/脚手架
  - `design` — 设计产出

示例：`T20260406-01-feat`、`T20260406-02-test`

### 任务清单文件路径

`docs/06_tasks/<功能ID>-<功能名>-tasks.md`

示例：`docs/06_tasks/F20260406-01-user-auth-tasks.md`

若功能ID未知（如独立任务），使用：`docs/06_tasks/YYYYMMDD-<关键词>-tasks.md`

### 任务清单文档格式

```markdown
<!-- PDLC-TASKS -->
<!-- 功能ID: F20260406-01 -->
<!-- 功能名称: user-auth -->
<!-- 关联PRD: docs/01_requirements/prd/F20260406-01-user-auth-prd.md -->
<!-- 最后更新: 2026-04-06 -->

# 任务清单：user-auth（F20260406-01）

## 总览
- 总任务数：N
- 待开始：N | 进行中：N | 已完成：N | 阻塞：N

## 任务列表

| 任务ID | 类型 | 描述 | 状态 | 估时 | 截止日期 | 关联文档 | 备注 |
|--------|------|------|------|------|---------|---------|------|
| T20260406-01-design | design | 创建 API 设计文档 | ⬜ 待开始 | 2h | 2026-04-07 | - | - |
| T20260406-02-design | design | 创建数据库设计文档 | ⬜ 待开始 | 1h | 2026-04-07 | - | - |
| T20260406-03-infra | infra | 生成代码脚手架 | ⬜ 待开始 | 0.5h | 2026-04-07 | - | - |
| T20260406-04-test | test | 编写单元测试 | ⬜ 待开始 | 3h | 2026-04-08 | - | - |
| T20260406-05-feat | feat | 实现注册接口 | ⬜ 待开始 | 4h | 2026-04-09 | - | - |
| T20260406-06-feat | feat | 实现登录接口 | ⬜ 待开始 | 2h | 2026-04-09 | - | - |
| T20260406-07-test | test | 运行测试确认绿灯 | ⬜ 待开始 | 1h | 2026-04-10 | - | - |
| T20260406-08-doc | doc | 创建评审记录 | ⬜ 待开始 | 1h | 2026-04-10 | - | - |

## 阻塞记录

| 任务ID | 阻塞原因 | 记录时间 | 解除时间 |
|--------|---------|---------|---------|
| （暂无） | - | - | - |
```

状态图标约定：
- `⬜ 待开始`
- `🔄 进行中`
- `✅ 已完成`
- `🚫 阻塞`

---

## 子命令执行流程

### plan <功能名或功能ID>

**前置检查**：
1. 从用户输入中提取功能名称关键词或功能ID
2. 在 `docs/01_requirements/prd/` 目录下搜索对应 PRD 文档
3. **未找到 PRD** → 输出以下信息后**立即停止，不继续执行**：
   ```
   ⛔ PDLC 守卫：未找到与「<功能名>」相关的 PRD 文档。
   任务拆解必须基于已有的 PRD。请先运行：
   👉 /pdlc-prd <需求描述>
   ```
4. **找到** → 提取功能ID，读取 PRD 内容，继续执行

**执行流程**：
1. 读取 PRD 文档，分析功能范围、用户故事和验收标准
2. 同时检查 `docs/02_design/` 下是否存在相关设计文档，有则一并读取
3. 扫描 `docs/06_tasks/` 目录，获取当日已有任务的最大序号，确保 ID 不重复
4. 按 PDLC 阶段顺序拆解任务：
   - **设计任务**（design）：需要产出的每份设计文档各一个任务
   - **基础设施任务**（infra）：目录初始化、脚手架生成
   - **测试任务**（test）：测试计划编写、测试代码编写
   - **功能实现任务**（feat）：每个独立接口/页面/模块各一个任务，粒度不超过半天工作量
   - **文档任务**（doc）：评审记录、CHANGELOG 更新
5. 为每个任务估算工时（0.5h 为最小单位）
6. 根据估时和 PDLC 阶段依赖关系，自动推算每个任务的**截止日期**：
   - 从今日日期开始，按阶段顺序排列（设计 → 基础设施 → 测试 → 功能实现 → 文档）
   - 同阶段内的任务可并行，截止日期相同
   - 下一阶段的开始日期 = 上一阶段截止日期的下一个工作日
   - 每日按 8h 工作量计算，超出的顺延到下一工作日
7. 在 `docs/06_tasks/` 下创建任务清单文档
8. 输出任务总览表格（含预计完成时间线）

### list [功能名或功能ID]

1. **有参数**：在 `docs/06_tasks/` 下查找对应功能的任务文件，输出该功能任务详情
2. **无参数**：扫描 `docs/06_tasks/` 下所有任务文件，汇总**非已完成**任务，按状态分组输出：
   - ⏰ 已逾期（截止日期早于今日且未完成的任务，**最先展示**）
   - 🔄 进行中
   - 🚫 阻塞（含阻塞原因）
   - ⬜ 待开始（按功能ID分组，仅展示最近 3 个功能）
3. 输出末尾追加整体完成率统计：`完成率: X/N (XX%)`
4. 若存在逾期任务，额外输出警告：`⚠️ 有 N 个任务已逾期，请及时处理`

### start <任务ID>

1. 在 `docs/06_tasks/` 下扫描所有任务文件，找到包含该任务ID的文件
2. **未找到** → 提示任务ID不存在后停止
3. **找到** → 将该任务状态从 `⬜ 待开始` / `🚫 阻塞` 更新为 `🔄 进行中`
4. 更新文件顶部的总览计数
5. 更新文件顶部的 `最后更新` 时间
6. 输出确认消息：`✓ 任务 <任务ID> 已标记为进行中`

### done <任务ID>

1. 在 `docs/06_tasks/` 下扫描所有任务文件，找到包含该任务ID的文件
2. **未找到** → 提示任务ID不存在后停止
3. **找到** → 将该任务状态更新为 `✅ 已完成`，在备注列填入完成时间
4. 更新文件顶部的总览计数和 `最后更新` 时间
5. 输出确认消息：`✓ 任务 <任务ID> 已完成`
6. 若该功能所有任务均已完成，额外输出：`🎉 功能 <功能ID> 全部任务已完成！`

### blocked <任务ID> <原因>

1. 在 `docs/06_tasks/` 下找到包含该任务ID的文件
2. **未找到** → 提示任务ID不存在后停止
3. **找到** → 将该任务状态更新为 `🚫 阻塞`，在备注列填入原因摘要
4. 在文档末尾的"阻塞记录"表格追加一行（任务ID、原因、当前时间）
5. 更新文件顶部的总览计数和 `最后更新` 时间
6. 输出确认消息：`⚠️ 任务 <任务ID> 已标记为阻塞：<原因>`

### reopen <任务ID>

1. 找到包含该任务ID的文件
2. **未找到** → 提示任务ID不存在后停止
3. **找到** → 将该任务状态更新为 `⬜ 待开始`，清空备注列
4. 若阻塞记录表格中有该任务，填入当前时间作为解除时间
5. 更新总览计数和 `最后更新` 时间
6. 输出确认消息：`✓ 任务 <任务ID> 已重新打开`

---

## 与 pdlc-status 联动

运行 `pdlc-status` 时，若 `docs/06_tasks/` 目录存在，自动在输出末尾追加：

```
## 任务进度
| 功能 | 总计 | 完成 | 进行中 | 阻塞 | 完成率 |
|------|------|------|--------|------|--------|
| F20260406-01 user-auth | 8 | 5 | 1 | 0 | 62% |
```

$ARGUMENTS

<!-- @include templates/prompts/state-update.md -->
<!-- @include templates/prompts/handoff.md -->