v3.0版本skills和agent

This commit is contained in:
2026-07-11 11:59:57 +08:00
parent 420f1b66c3
commit 69d27c80be
15 changed files with 1236 additions and 42 deletions
+20 -12
View File
@@ -8,9 +8,10 @@
| 阶段 | 手册 | 说明 |
|------|------|------|
| **当前 V3 交付** | [`杜康好客-v3编码手册.md`](./杜康好客-v3编码手册.md) | 业务闭环交付验收标准 |
| **当前 V3.0 交付** | [`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md) | 产品需求事实源(三波交付) |
| **V3 实现验收** | [`杜康好客-v3编码手册.md`](./杜康好客-v3编码手册.md) | 业务闭环、核销、分工 |
| **preV1 历史** | [`杜康好客-preV1编码手册.md`](./杜康好客-preV1编码手册.md) | Mock 联调裁剪(历史参考) |
| **V2 蓝图** | [`杜康好客-V2编码手册.md`](./杜康好客-V2编码手册.md) | 完整产品蓝图(与 V3 冲突时 V3 优先) |
| **V2 蓝图** | [`杜康好客-V2编码手册.md`](./杜康好客-V2编码手册.md) | 完整产品蓝图(与 V3 冲突时 V3 PRD 优先) |
**禁止**:臆造 PRD 未定义规则;依赖 `doc/` 下过时文档;跨 OWNER 直写他人 Prisma 表。
@@ -45,8 +46,9 @@ Mock 验证码:`123456`。测试账号见 [`README.md`](./README.md)。
## 文档优先级(冲突时)
1. `杜康好客-v3编码手册.md` — V3 交付业务规则与验收
2. `杜康好客-V2编码手册.md` §二 — 完整蓝图(与 V3 冲突时 V3 优先)
1. `杜康好客-v3-PRD.md` — V3.0 产品需求与三波交付范围
2. `杜康好客-v3编码手册.md` — V3 实现验收、核销规则、分工
3. `杜康好客-V2编码手册.md` §二 — 完整蓝图(与 V3 冲突时 V3 PRD 优先)
3. `杜康好客-preV1编码手册.md` — preV1 裁剪(历史参考)
4. [`conventions.md`](./conventions.md) — 协作与模块边界
5. V2 手册 §四 §五 §六 — 架构 / DB / API
@@ -81,9 +83,10 @@ Mock 验证码:`123456`。测试账号见 [`README.md`](./README.md)。
|------|------|------|
| Rules | `.cursor/rules/` | 自动加载的编码规范 |
| 编码 Skill | `.cursor/skills/dukang-coding/` | @dukang-coding |
| V3.0 需求 Skill | `.cursor/skills/dukang-v3/` | @dukang-v3PRD、Wave、REQ/ACC |
| 需求 Skill | `.cursor/skills/dukang-project/` | @dukang-project |
| preV1 Skill | `.cursor/skills/dukang-prev1/` | Mock / Feature Flag |
| 任务卡 Skill | `.cursor/skills/dukang-task-card/` | P1-* / M*-* |
| 任务卡 Skill | `.cursor/skills/dukang-task-card/` | DLV-W* / P1-* / M*-* |
## 子 Agent(按职责选用)
@@ -91,7 +94,9 @@ Mock 验证码:`123456`。测试账号见 [`README.md`](./README.md)。
| 子 Agent | 负责人 | 适用场景 |
|----------|--------|----------|
| `owner-a-user-trade` | jacy-dukang | C 端 H5、订单、支付、权益、埋点 |
| `v3-delivery-lead` | jacy-dukang | V3.0 三波交付统筹、DLV 拆分、跨 Owner 协调 |
| `v3-req-reviewer` | — | V3.0 需求只读审查、REQ/ACC 缺口分析 |
| `owner-a-user-trade` | jacy-dukang | C 端、订单、支付、权益、埋点 |
| `owner-c-catalog-ops` | jacy-dukang | admin-web、开城商品、结算、运营 |
| `backend-lead` | jacy-dukang | packages、callbacks、jobs、Prisma 横切 |
| `owner-b-partner-store` | 刘景尧 | 合伙人 H5、门店 CRUD/审核 |
@@ -102,15 +107,18 @@ Mock 验证码:`123456`。测试账号见 [`README.md`](./README.md)。
| Skill | 何时用 |
|-------|--------|
| `dukang-v3` | V3.0 PRD、Wave 门禁、REQ/ACC 对照、三波交付规划 |
| `dukang-coding` | 实现功能、修 Bug(通用编码流程) |
| `dukang-project` | PRD/需求评审、原型对照、任务卡规划(**不用于日常编码**) |
| `dukang-prev1` | Mock 开关、preV1 裁剪、Feature Flag |
| `dukang-task-card` | 领取任务卡 `P1-*` / `M*-*` 并按 DoD 交付 |
| `dukang-task-card` | 领取任务卡 `DLV-W*-*` / `P1-*` / `M*-*` 并按 DoD 交付 |
## 快速指令
- 实现任务卡`@dukang-coding 实现 P1-M2-002`
- 需求评审`@dukang-project 对照 pages/partner/ 评审 PRD`
- V3.0 需求评审`@dukang-v3 对照 REQ-U-007 评审现状`
- 实现 DLV 任务`@dukang-coding 实现 DLV-W1-M2`
- 波次规划:`/v3-delivery-lead 拆分 Wave 2 任务`
- 需求缺口审查:`/v3-req-reviewer 审查门店提现`
- PR 前审查:`/boundary-reviewer`
- 原型参照:`pages/{user,shop,partner}/`(只读)
@@ -119,16 +127,16 @@ Mock 验证码:`123456`。测试账号见 [`README.md`](./README.md)。
```
权益额 = benefit_amount ?? price
同城起购 2 瓶 / 跨城 6 瓶
核销:直接核销 0 < amount ≤ 全部 ACTIVE 权益总余额;带单据核销 0 < amount ≤ 该单据可用金额;Redis 码 5 分钟
核销:直接核销 0 < amount ≤ 全部 ACTIVE 权益总余额;带单据核销 0 < amount ≤ 该单据可用金额;Redis 码 3 分钟
C 端门店仅 status=OPEN
订单 Taball | pending_pay | pending_ship | pending_receive | completed
订单 Tab待付款 | 已付款 | 已完成
```
## 提交与 PR
- Conventional Commits`feat(trade):``fix(redeem):`scope = 端或模块
- 跨模块 PR → jacy-dukang + 刘景尧 共同 Review(若涉及双方模块)
- 改 API/表 → 同步 V2 手册 §五/§六 + `shared-types`
- 改 API/表 → 同步 v3-PRD + v3编码手册 + `shared-types`
- 不提交 `.env``dist/``node_modules/`
## 完成定义(DoD