---
name: dukang-project
description: >-
  Manages 杜康好客 PRD, requirements review, prototype mapping, and task card
  planning. Use when writing PRD, reviewing requirements, mapping prototypes to
  features, or splitting task cards. Not for daily coding (use @dukang-coding).
disable-model-invocation: true
---

# 杜康好客 · 项目/需求 Skill

## 何时启用

- 写或改 PRD、业务规则
- 评审需求、对照原型
- 拆分或规划任务卡
- 用户 @dukang-project

**不用于**：日常编码、修 Bug（用 @dukang-coding）

## 文档阅读顺序

| 优先级 | 文档 | 用途 |
|--------|------|------|
| 1 | `杜康好客-v3-PRD.md` | **唯一需求事实源** |
| 2 | `杜康好客-v3-现状对照.md` | 已完成/冲突/缺口 |
| 3 | `杜康好客-v3编码手册.md` | 实现验收、分工 |
| 4 | `conventions.md` | 协作与模块边界 |
| 5 | V2 手册 §四 §五 §六 | 仅架构/DB/API 参考（与 V3 冲突时忽略） |
| 6 | `pages/{user,shop,partner,hq}/` | UI 参照 |

> V2 / preV1 **不再作为需求依据**。

## 需求变更规则

- **只改** `杜康好客-v3-PRD.md`；进度同步 `杜康好客-v3-现状对照.md`
- 编码 Agent **不得**边写代码边改业务规则
- 改 API/表结构 → 同步 v3-PRD + `packages/shared-types`

## 原型 → 模块映射

| 端 | 原型目录 | 主要 API 前缀 | NestJS Module |
|----|----------|---------------|---------------|
| C 端 | pages/user/ | /auth, /user, /catalog, /trade, /benefit, /redeem, /stores | iam, catalog, trade, benefit, redeem, store |
| 门店 | pages/shop/ | /shop/auth, /shop/redeem, /shop/store | iam, redeem, store |
| 合伙人 | pages/partner/ | /partner/* | iam, store, trade, settlement |
| 总部 | pages/hq/ | /admin/* | iam, catalog, store, trade, settlement, ops |

## 任务卡格式

- ID 格式：`Mx-LAYER-NNN`（如 `M2-BE-TRD-002`）
- 任务卡全集：V2 手册 §七 附录 A
- preV1 任务卡：preV1 手册 §9

## 团队 OWNER

| OWNER | 前端 | 后端 Module |
|-------|------|-------------|
| A | h5-user | iam, trade, benefit, analytics |
| B | h5-partner | store |
| C | admin-web | catalog, settlement, ops |
| D | h5-shop | redeem |
| Lead | packages/* | callbacks, jobs, common |

## 输出要求

- 需求文档变更需标注影响模块与 Owner
- 新任务卡需含：PRD §、API 路径、DB 表、原型路径、验收标准
- 跨模块 PR 需相关双 Owner Review