69 lines
2.4 KiB
Markdown
69 lines
2.4 KiB
Markdown
---
|
||
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
|