---
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 | `杜康好客-V2编码手册.md` §二 | **做什么**（业务规则、状态、边界） |
| 2 | `conventions.md` | **怎么协作**（模块边界、提交） |
| 3 | V2 手册 §四 | **怎么架构**（NestJS 模块） |
| 4 | V2 手册 §五 | **表结构**（Prisma / SQL） |
| 5 | V2 手册 §六 | **接口契约**（四端 JWT） |
| 6 | `pages/{user,shop,partner,hq}/` | **UI 参照** |
| 7 | `杜康好客-preV1编码手册.md` | preV1 联调范围 |

## 需求变更规则

- **只改** `杜康好客-V2编码手册.md` 作为业务事实源
- 编码 Agent **不得**边写代码边改业务规则
- 改 API/表结构 → 同步手册 §五/§六 + `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