---
name: dukang-task-card
description: >-
  Executes Dukang Haoke task cards (P1-M* or M0-M6) one at a time with DoD
  verification. Use when the user provides a task ID like P1-M2-002 or M2-FE-U-003,
  or asks to start/implement a milestone card from the coding manuals.
---

# 杜康好客 · 任务卡 Skill

## 原则

- **一次只做一个任务卡**
- 任务卡 ID 命名空间：`DLV-W*-*`（V3.0）· `P1-*` / `M*-*`（**历史，不再作验收依据**）
- 需求变更只改 `杜康好客-v3-PRD.md`；进度查 `杜康好客-v3-现状对照.md`

## 领取流程

1. **解析 ID** → 确定里程碑与 OWNER
   - `DLV-W1-M2` → `@dukang-v3` + [reference-waves.md](../dukang-v3/reference-waves.md)
   - `P1-M2-002` → preV1 §9 + OWNER 见卡片内容
   - `M2-BE-TRD-002` → V2 §七 附录 A
2. **读验收标准** → ACC-ID（V3）或手册中该 ID 的「验收」列
3. **读依赖** → REQ-ID、API 路径、DB 表、原型路径
4. **确认边界** → 只改 [`AGENTS.md`](../../AGENTS.md) OWNER 表内路径
5. **实现** → 配合 `dukang-coding` skill
6. **自验 DoD** → 下方清单

## OWNER 快速映射（2 人）

| 领域 | 负责人 | 典型 ID |
|------|--------|---------|
| C 端 FE、h5-user、交易后端 | jacy-dukang | P1-M1-002, M2-* |
| admin、catalog、settlement | jacy-dukang | M1-BE-CAT-* |
| 合伙人、store | 刘景尧 | P1-M4-001 |
| 门店核销、h5-shop | 刘景尧 | P1-M3-002 |
| Monorepo/integrations | jacy-dukang | P1-M0-* |

## preV1 任务卡（精简）

| ID | 验收要点 |
|----|----------|
| P1-M0-001 | 三端 `pnpm dev` 可编译 |
| P1-M0-003 | `pnpm db:validate` 通过 |
| P1-M0-004 | Seed 郑州+4SKU+测试账号 |
| P1-M1-001 | 123456 三端登录 |
| P1-M1-002 | C 端首页 4 款酒 |
| P1-M2-001 | 起购校验 2/6 瓶 |
| P1-M2-002 | Mock 支付发券 |
| P1-M2-003 | 5 Tab 含 pending_ship |
| P1-M3-001 | V3 两路径核销金额限制 |
| P1-M3-002 | 门店扫码核销 |
| P1-M4-001 | 录店 AUTO_APPROVE → C 端可见 |
| P1-M5-001 | 配送自动推进到 COMPLETED |

完整列表：preV1 手册 §9。

## 完成定义（每个任务卡）

```
- [ ] 验收列每一条可演示/可脚本验证
- [ ] 改动在 OWNER 路径内（跨模块需 inject Service + 双 OWNER 知晓）
- [ ] 新枚举/DTO → shared-types
- [ ] 纯规则 → domain + 单测（若涉及起购/权益/核销）
- [ ] API/表变更 → 同步 V2 手册 §五/§六
- [ ] pnpm lint 无新增错误
```

## V3.0 DLV 顺序（当前交付）

**Wave 1**：DLV-W1-M1 → M2 → M3 → M4（门禁 W1-S1~S4）

**Wave 2**：DLV-W2-M1 → M2 → M3 → M4（门禁 W2-S1~S5）

**Wave 3**：DLV-W3-M1 → M2 → M3 → M4 → M5（全量 ACC）

## 历史里程碑

**preV1**：P1-M0 → … → P1-M6

**V2**：M0 → M1 → … → M6 → 上线

除非用户指定，默认从当前里程碑**下一个未完成**任务卡开始；不确定时先问用户或跑 smoke 判断进度。

## 输出格式（任务完成时）

```markdown
## 任务卡 {ID} 完成

**改动范围**：（路径列表）
**验收**：（逐条 ✓）
**未做/阻塞**：（如有，需其他 OWNER 配合的项）
**建议下一步**：（下一任务卡 ID）
```