95 lines
3.1 KiB
Markdown
95 lines
3.1 KiB
Markdown
---
|
||
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）
|
||
```
|