refactor(config): 按照技能配置规范重构技能配置

1. 移除SkillSet中硬编码的buff效果，将6104技能替换为通用6101底座 2. 所有英雄/怪物技能通过overrides注入buff和数值修改 3. 新增项目技能配置规范文档
2026-08-15 20:40:56 +08:00
parent 168501ac91
commit 93e02fa292
3 changed files with 101 additions and 17 deletions
--- a/.trae/rules/project_rules.md
+++ b/.trae/rules/project_rules.md
@@ -57,3 +57,92 @@ alwaysApply: true
 - 代码前指明使用了 oops-framework 哪个模块
 - `oops` API 调用附带简明中文注释
 - 检查所有监听是否在生命周期结束时注销
+
+---
+
+# SkillSet / heroSet 配置规则
+
+## 核心原则
+
+1. **技能底座纯净化**：SkillSet 中的技能只定义基础行为（伤害、弹道、命中），**禁止**在基础配置中写死 `timed_buff_id` / `buff_type` 等效果字段
+2. **效果由引用处注入**：英雄/怪物引用技能时，通过 `HSkillInfo.overrides` 按需附加 debuff/buff，实现"同一技能、不同效果"
+3. **数值覆盖优先**：`ap`（伤害百分比）、`hit_count`、`crt` 等数值差异，统一由 `overrides` 覆写，而非新建相似技能
+
+## SkillSet 配置规范
+
+### 技能 uuid 段位分配
+
+| 段位 | 用途 | 示例 |
+|------|------|------|
+| 6001-6099 | 基础单体攻击（近战/远程通用底座） | 6001 飞剑、6004 攻击 |
+| 6100-6199 | 中阶攻击技能（高阶特效/多命中） | 6101 火球、6102 飓风 |
+| 6200-6299 | 高阶范围技能（AOE/必杀） | 6201 陨石术 |
+| 6300-6399 | 辅助/治疗/护盾技能 | 6301 护盾、6302 治疗 |
+| 6400-6499 | 永久属性强化（buff_type） | 6401 攻击强化 |
+| 6500-6599 | 计时爆发技能（timed_buff_id） | 6501 复活 |
+
+### 新增技能检查清单
+
+- [ ] uuid 在对应段位内，且未与现有技能冲突
+- [ ] `sp_name` / `icon` 与现有技能不重复（避免视觉混淆）
+- [ ] `IType`（近战/远程/辅助）与 `RType`（弹道类型）匹配合理
+- [ ] 基础配置**不含** `timed_buff_id` / `buff_type`（效果由引用处注入）
+- [ ] `info` 描述只写基础效果，不写具体 debuff（如"造成攻击力100%的伤害"）
+
+## heroSet 配置规范
+
+### 英雄 uuid 段位分配
+
+| 段位 | 品质 | 说明 |
+|------|------|------|
+| 5001-5099 | card_lv=1 | 基础单体/默认范围 |
+| 5101-5199 | card_lv=2 | 数值强化 |
+| 5201-5299 | card_lv=3 | 范围扩大 |
+| 5301-5399 | card_lv=4 | 数值+范围 |
+| 5401-5499 | card_lv=5 | 双技能（+revive/field） |
+
+### 怪物 uuid 段位分配
+
+| 段位 | 类型 |
+|------|------|
+| 6001-6099 | 基础怪物（近战/远程/特殊位） |
+| 6100-6199 | Boss 怪物 |
+
+### 新增英雄/怪物检查清单
+
+- [ ] `skills` 引用的技能 uuid 在 SkillSet 中存在
+- [ ] 技能效果通过 `overrides` 按需注入，**禁止**直接修改 SkillSet 基础配置
+- [ ] `overrides.ap` 明确写出（如 80/100/150），避免依赖基础配置的默认值
+- [ ] `timed_buff_id` 指向 BuffList 中存在的 buff 配置
+- [ ] 怪物技能引用优先使用 6001-6012 基础技能，Boss 可用 6101+ 中阶技能
+
+### 触发技能配置规则
+
+| 触发类型 | 字段 | 说明 |
+|----------|------|------|
+| 普通攻击 | `skills` | 携带技能，`overrides` 注入效果 |
+| 受击触发 | `atked` | 按 s_uuid 分组，按 lv 升序 |
+| 攻击后触发 | `atking` | 按 s_uuid 分组，按 lv 升序 |
+| 死亡触发 | `dead` | 按 s_uuid 分组，按 lv 升序 |
+| 战斗开始 | `fstart` | 按 s_uuid 分组，按 lv 升序 |
+| 驻场光环 | `field` | `FieldEntry[]`，按 lv 升序 |
+| 复活 | `revive` | `LvReviveEntry[]`，按 lv 升序 |
+
+### 示例：同一技能不同效果
+
+```typescript
+// SkillSet 6101 火球 — 纯伤害底座，无 debuff
+6101: {
+    uuid: 6101, name: "火球", sp_name: "fb-1", ...,
+    // 禁止写 timed_buff_id / buff_type
+}
+
+// heroSet 5004 破晓先知 — 冰冻版火球
+skills: { 6101: { uuid: 6101, overrides: { ap: 80, timed_buff_id: 7003 } } }
+
+// heroSet 5304 战吼术士 — 中毒版火球
+skills: { 6101: { uuid: 6101, overrides: { ap: 80, timed_buff_id: 7005 } } }
+
+// heroSet 6008 兽人火法 — 原版火球（ap=100，无 debuff）
+skills: { 6101: { uuid: 6101 } }
+```
--- a/assets/script/game/common/config/SkillSet.ts
+++ b/assets/script/game/common/config/SkillSet.ts
@@ -280,12 +280,7 @@ export const SkillSet: Record<number, SkillConfig> = {
        DTType: DTType.single, ap: 100, hit_count: 2, hitcd: 0.3, speed: 720, with: 90, ready: 0.2, EAnm: 0, DAnm: "", IType: IType.remote,
        RType: RType.linear, EType: EType.collision, info: "造成攻击力100%的伤害, 高阶技能",
    },
-    // DoT 技能：命中附加易伤（7002，受到伤害附加固定值，可被易伤抗性减免）
-    6104: {
-        uuid: 6104, name: "灼热火球", sp_name: "fb-1", icon: "Stat_FireDamage", TGroup: TGroup.Enemy, readyAnm: "", endAnm: "", act: "atk",
-        DTType: DTType.single, ap: 80, hit_count: 2, hitcd: 0.3, speed: 720, with: 90, ready: 0.2, EAnm: 0, DAnm: "", IType: IType.remote,
-        RType: RType.bezier, EType: EType.collision, timed_buff_id: 7002, info: "造成攻击力80%的伤害, 命中附加易伤(5秒内受到伤害附加固定值)",
-    },
+    // 6201 陨石术
    6201: {
        uuid: 6201, name: "陨石术", sp_name: "fb-3", icon: "Stat_Tripleshot", TGroup: TGroup.Enemy, readyAnm: "blues", endAnm: "", act: "max",
        DTType: DTType.aoe_grid, stun: 0, ap: 150, hit_count: 6, hitcd: 0.2, speed: 720, with: 0, ready: 0.2, EAnm: 0, DAnm: "", IType: IType.remote,
--- a/assets/script/game/common/config/heroSet.ts
+++ b/assets/script/game/common/config/heroSet.ts
@@ -1,4 +1,4 @@
-import { v3 } from "cc"
+import { v3 } from "cc"
 import { BoxSet, FacSet, FightSet } from "./GameSet"
 import { SkillOverrides, TGroup, SkillSet, FieldSkillSet, SkillConfig, SkillKind, FieldSkillConfig, FieldSkillType, mergeSkillParams } from "./SkillSet"
 import { BuffList, BuffConfig, ModOp } from "./BuffSet"
@@ -424,7 +424,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5004 破晓先知 — fstart 全队攻击
    5004: {
        uuid: 5004, name: "破晓先知", path: "hm1", fac: FacSet.HERO, card_lv: 1, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Mage, hp: 143, ap: 32,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7003 } } },
        fstart: {
            6401: [
                { lv: 1, s_lv: SkillLv.Lv1, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 3 } },
@@ -437,7 +437,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5005 战歌法师 — field 攻击光环
    5005: {
        uuid: 5005, name: "战歌法师", path: "hm2", fac: FacSet.HERO, card_lv: 1, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Support, hp: 143, ap: 32,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7006 } } },
        field: [
            { lv: 1, uuids: [{ uuid: 7002, value: 0.1 }] },
            { lv: 3, uuids: [{ uuid: 7002, value: 0.2 }] },
@@ -490,7 +490,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5104 圣光祭司 — fstart 全队护盾（更高数值）
    5104: {
        uuid: 5104, name: "圣光祭司", path: "hm3", fac: FacSet.HERO, card_lv: 2, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Mage, hp: 287, ap: 64,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7003 } } },
        fstart: {
            6301: [
                { lv: 1, s_lv: SkillLv.Lv1, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 3 } },
@@ -503,7 +503,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5105 风怒先知 — field 攻速光环
    5105: {
        uuid: 5105, name: "风怒先知", path: "hm1", fac: FacSet.HERO, card_lv: 2, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Support, hp: 287, ap: 64,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7006 } } },
        field: [
            { lv: 1, uuids: [{ uuid: 7006, value: 0.1 }] },
            { lv: 3, uuids: [{ uuid: 7006, value: 0.2 }] },
@@ -569,7 +569,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5204 晨光贤者 — fstart 全队暴击（范围扩大）
    5204: {
        uuid: 5204, name: "晨光贤者", path: "hm2", fac: FacSet.HERO, card_lv: 3, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Mage, hp: 430, ap: 96,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7002 } } },
        fstart: {
            6403: [
                { lv: 1, s_lv: SkillLv.Lv1, t_num: 1, overrides: { TGroup: TGroup.Team, timed_buff_id: 7012, buff_value: 5, buff_duration: 5 } },
@@ -582,7 +582,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5205 精准术士 — field 暴击光环（范围扩大）
    5205: {
        uuid: 5205, name: "精准术士", path: "hm3", fac: FacSet.HERO, card_lv: 3, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Support, hp: 430, ap: 96,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7006 } } },
        field: [
            { lv: 1, uuids: [{ uuid: 7004, value: 0.1 }] },
            { lv: 3, uuids: [{ uuid: 7004, value: 0.2 }] },
@@ -640,7 +640,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5304 战吼术士 — fstart 全队攻击+生命（双效果）
    5304: {
        uuid: 5304, name: "战吼术士", path: "hm1", fac: FacSet.HERO, card_lv: 4, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Mage, hp: 573, ap: 128,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7005 } } },
        fstart: {
            6401: [
                { lv: 1, s_lv: SkillLv.Lv1, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 5 } },
@@ -658,7 +658,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5305 领域贤者 — field 暴伤+攻速光环（双效果）
    5305: {
        uuid: 5305, name: "领域贤者", path: "hm2", fac: FacSet.HERO, card_lv: 4, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Support, hp: 573, ap: 128,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7006 } } },
        field: [
            { lv: 1, uuids: [{ uuid: 7005, value: 0.2 }, { uuid: 7006, value: 0.1 }] },
            { lv: 3, uuids: [{ uuid: 7005, value: 0.4 }, { uuid: 7006, value: 0.2 }] },
@@ -731,7 +731,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    // 5404 涅槃贤者 — fstart 护盾+攻击 + revive（双技能）
    5404: {
        uuid: 5404, name: "涅槃贤者", path: "hm3", fac: FacSet.HERO, card_lv: 5, lv: 1, type: HType.Long, grow_type: HGrowType.Mage, role: HRole.Mage, hp: 717, ap: 160,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } },
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7004 } } },
        fstart: {
            6301: [
                { lv: 1, s_lv: SkillLv.Lv1, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 5 } },
@@ -837,7 +837,7 @@ export const HeroInfo: Record<number, heroInfo> = {
    },
    6105: {
        uuid: 6105, name: "亡灵首领-法师", path: "mb5", fac: FacSet.MON, lv: 6, type: HType.Long, monType: MonType.LongBoss, hp: 1000, ap: 30, speed: 110,
-        skills: { 6104: { uuid: 6104, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0 } }, info: "后排高AP Boss"
+        skills: { 6101: { uuid: 6101, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow].cd, ccd: 0, overrides: { ap: 80, timed_buff_id: 7002 } } }, info: "后排高AP Boss"
    },
    6106: {
        uuid: 6106, name: "亡灵首领-骑马战士", path: "mb6", fac: FacSet.MON, lv: 6, type: HType.Melee, monType: MonType.MeleeBoss, hp: 1800, ap: 20, speed: 130,