Files

T

2026-07-12 07:29:14 +08:00

4.3 KiB

Raw Blame History

name, description, disable-model-invocation

name	description	disable-model-invocation
dukang-v3	Manages 杜康好客 V3.0 PRD (v3-PRD), three-wave delivery (W1/W2/W3), REQ/ACC IDs, and requirements review. Use when implementing V3.0 features, reviewing PRD v1.3 scope, planning Wave gates, or user @dukang-v3. Not for preV1 Mock (use @dukang-prev1) or daily coding alone (pair with @dukang-coding).	true

杜康好客 · V3.0 需求 Skill

何时启用

读/改 V3.0 业务规则与交付范围
评审需求、对照 PRD REQ-ID / ACC-ID
规划或验收 Wave 1/2/3 门禁
用户 @dukang-v3 或提到「v3.0 PRD」「三波交付」「W1-S1」

不用于：preV1 Mock 联调（@dukang-prev1）、纯编码实现（@dukang-coding）

文档阅读顺序

优先级	文档	用途
1	`杜康好客-v3-PRD.md`	唯一需求事实源
2	`杜康好客-v3-现状对照.md`	已完成/冲突/缺口
3	`杜康好客-v3编码手册.md`	实现验收、分工
4	reference-waves.md	Wave 门禁与 DLV 映射
5	reference-req-index.md	REQ-U/S/P/H 全表
6	reference-acc.md	ACC 验收条件
7	`pages/{user,shop,partner,hq}/`	UI 参照

V2 / preV1 手册不再作为需求依据。

V3.0 不可偏离常量

权益额 = 订单实付 1:1（永久）
同城起购 2 瓶 / 跨城 1 箱(6瓶)
门店结算 = 核销额 × 60%
单合伙人：订单佣金 + 核销佣金 ≤ 5%（默认 0% + 3%）
核销码 TTL = 3 分钟；试核销固定 ¥100
订单 Tab：待付款 | 已付款 | 已完成
C 端门店仅 status=OPEN 且审核通过

三波交付（严格顺序）

Wave 1 (7.10) → Wave 2 (7.15) → Wave 3 (7.22)

实现前必须确认当前 Wave；不得提前做后续 Wave 功能（除非用户明确要求）。

Wave	门禁	一句话
W1	W1-S1~S4	下单+核销+拓店+合伙人子账号
W2	W2-S1~S5	提现+推广码+现场提货+门店子账号+多合伙人
W3	全量 G1~G5	代下单+弱网+多仓+跨城+工单+发票+增长

详情：reference-waves.md

需求变更规则

只改 杜康好客-v3-PRD.md 作为 V3.0 业务事实源
同步 杜康好客-v3编码手册.md + packages/shared-types + packages/domain
V2/preV1 与 V3.0 冲突时 V3.0 PRD 优先
编码 Agent 不得边写代码边改业务规则

原型 → 模块映射

端	PRD 形态	当前代码	后端 Module
C 端	微信小程序	`apps/h5-user`（过渡）	iam, catalog, trade, benefit
门店	H5	`apps/h5-shop`	iam, redeem, store
合伙人	H5	`apps/h5-partner`	iam, store, trade, settlement
总部	H5	`apps/admin-web`（过渡）	catalog, store, trade, settlement, ops

任务卡命名（V3.0）

DLV-W{n}-M{m}：阶段交付（如 DLV-W1-M2）
REQ-{U|S|P|H}-{nnn}：功能需求 ID
ACC-{nnn} / ACC-P{nn} / ACC-W{nn}：验收 ID
preV1 P1-* 与 V2 M*-* 为历史命名，V3.0 新任务以 DLV/REQ/ACC 为准

领取 DLV 任务时配合 @dukang-coding + 对应 Owner agent。

团队 OWNER（2 人）

负责人	前端	后端 Module
jacy-dukang	h5-user/mini-user, admin-web	iam, trade, benefit, catalog, settlement, ops, analytics
刘景尧	h5-shop, h5-partner	store, redeem

需求评审输出格式

## V3.0 需求评审 · {主题}

**关联**：REQ-xxx / ACC-xxx / Wave N
**影响模块**：（NestJS module + app）
**Owner**：jacy-dukang | 刘景尧 | 双方
**与现状差异**：（代码/手册冲突点）
**建议任务**：DLV-Wx-Mx
**阻塞/依赖**：（外部对接、前置 Wave）

子 Agent 选用

场景	Agent
V3 波次统筹、跨 Wave 排期	`v3-delivery-lead`
C 端下单/权益/支付	`owner-a-user-trade`
总部开城/结算/运营	`owner-c-catalog-ops`
合伙人拓店	`owner-b-partner-store`
门店核销	`owner-d-shop-redeem`
packages/integrations/Prisma	`backend-lead`
PR 边界审查	`boundary-reviewer`

4.3 KiB Raw Blame History Unescape Escape