docs: 修正进度系统文档中虚构的技能树系统

将 10_Manual_ProgressionSystem.md 中不存在的 SkillTreeSO/技能点/技能树解锁
流程，改写为真实实现：技能(FormSkillSO)随形态由 FormController 注入 SkillManager，
施放消耗魂力/灵力；能力通过 AbilityType 位掩码解锁(PlayerStats/AbilityFlags)。
同步更正 MT-PROG-06 的 HasAbility/存档字段引用，并统一 05/07/11 文档措辞为
'形态技能一览(FormSkillPanel)'，明确本项目无技能树。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Docs/Verification/10_Manual_ProgressionSystem.md

@@ -11,14 +11,16 @@
 
 | 工具 | 用途 | 菜单路径 |
 |------|------|----------|
-| **Validate All ScriptableObjects** | 遍历所有实现 `IValidatable` 的 SO，输出验证结果（含 SkillTreeSO、QuestDatabaseSO 等） | `BaseGames → Tools → Validate All ScriptableObjects` |
+| **Validate All ScriptableObjects** | 遍历所有实现 `IValidatable` 的 SO，输出验证结果（含 FormSkillSO、QuestDatabaseSO 等） | `BaseGames → Tools → Validate All ScriptableObjects` |
 
-> **注意**：PlayModeDebugOverlay 已移除。Geo 注入、技能点测试等请通过 Inspector 直接修改对应 Manager 字段，或临时编写 Editor 脚本触发。  
+> **注意**：PlayModeDebugOverlay 已移除。Geo 注入、能力解锁测试等请通过 Inspector 直接修改对应 SO/Manager 字段，或临时编写 Editor 脚本触发。  
 > Tab 10 的场景摆放工具（Add Quest Trigger、Add Shop NPC）已不再提供；请参照下方各节**手动步骤**手工创建对应对象。
+>
+> **重要：本项目没有"技能点 + 技能树解锁"系统。** 技能（`FormSkillSO`）随形态绑定，由 `FormController` 在切换形态时注入 `SkillManager`，无需花费技能点解锁；`SkillTreePanel` 仅为只读的形态技能一览面板。能力（二段跳/冲刺/形态等）通过 `AbilityType` 位掩码解锁（见 MT-PROG-06），不涉及任何技能树。
 
 **典型工作流**：
 1. 测试前：`BaseGames → Tools → Validate All ScriptableObjects` 一键确认 SO 存在；若有缺失，Console 给出路径提示。
-2. `MT-PROG-01` 技能：进入 Play Mode，通过 Inspector 直接修改 `SkillManager._skillPoints` 字段，在技能树 UI 解锁目标技能。
+2. `MT-PROG-01` 技能：进入 Play Mode，通过 `FormController` 切换形态，确认 `SkillManager` 注入对应形态的三个技能，施放消耗魂力/灵力并进入冷却。
 3. `MT-PROG-03` 任务：手动放置 `QuestGiver` NPC（见下方步骤），将 `QuestSO` 拖入 Inspector，Play Mode 中交互验证。
 4. `MT-PROG-05` 商店：手动放置 `ShopNPC`（见下方步骤），通过 Inspector 修改 `_geo` 字段给玩家加钱，交互购买。
 
@@ -27,7 +29,7 @@
 ## 目录
 
 1. [前置数据检查](#1-前置数据检查)
-2. [MT-PROG-01：技能解锁与使用](#mt-prog-01技能解锁与使用)
+2. [MT-PROG-01：形态技能与施放](#mt-prog-01形态技能与施放)
 3. [MT-PROG-02：装备系统（护符/武器）](#mt-prog-02装备系统护符武器)
 4. [MT-PROG-03：任务系统（QuestManager）](#mt-prog-03任务系统questmanager)
 5. [MT-PROG-04：成就系统（AchievementManager）](#mt-prog-04成就系统achievementmanager)
@@ -40,7 +42,7 @@
 
 | 资产 | 路径（示例） | 必要性 | ✓ |
 |------|------------|--------|---|
-| SkillTreeSO | `Assets/Data/Skills/SkillTree.asset` | 技能测试必须 | ☐ |
+| FormSkillSO ×N | `Assets/_Game/Data/Skills/SKL_*.asset` | 技能测试必须（每形态 3 个：魂技+灵技1+灵技2） | ☐ |
 | EquipmentSlotConfigSO | `Assets/Data/Equipment/SlotConfig.asset` | 装备测试必须 | ☐ |
 | QuestDatabaseSO | `Assets/Data/Quests/` | 任务测试必须 | ☐ |
 | AchievementDatabaseSO | `Assets/Data/Achievements/` | 成就测试必须 | ☐ |
@@ -59,71 +61,85 @@
 >
 > | 资产 | 创建方法 |
 > |------|----------|
-> | `SkillTreeSO` | Project 右键 → Create → BaseGames → Skills → Skill Tree，保存到 `Assets/_Game/Data/Skills/` |
+> | `FormSkillSO` | Project 右键 → Create → BaseGames → Skills → Form Skill，保存到 `Assets/_Game/Data/Skills/`，命名 `SKL_{skillId}`；如有近战/爆炸判定再配套 `SKL_{skillId}_HitBox` 预制体 |
 > | `EquipmentSlotConfigSO` | Project 右键 → Create → BaseGames → Equipment → Slot Config，保存到 `Assets/_Game/Data/Equipment/` |
 > | `QuestDatabaseSO` | Project 右键 → Create → BaseGames → Quest → Quest Database，保存到 `Assets/_Game/Data/Quests/` |
 > | `AchievementDatabaseSO` | Project 右键 → Create → BaseGames → Progression → Achievement Database，保存到 `Assets/_Game/Data/Achievements/` |
 > | `ShopInventorySO` | 已由 Create Test Assets 创建为 `ShopInventory_Test.asset`；点 Inspector 的 `+` 按钮添加 `ShopItem` 条目 |
 >
 > **步骤 4 — 绑定 Manager 字段**（Play Mode 前）：
-> - 找到 `SkillManager` GameObject → Inspector → `_skillTree` 字段拖入 `SkillTree.asset`
+> - 找到 Player 上的 `SkillManager` 组件 → Inspector → `_formSkillSets` 数组，按形态（天魂/地魂/命魂）逐项填入 `soulSkill` + `spiritSkill1` + `spiritSkill2`（对应 `FormSkillSO` 资产）
 > - 找到 `ShopNPC` GameObject（Tab 10 → 添加商店 NPC）→ `_inventory` 字段拖入 `ShopInventory_Test.asset`
 
 ---
 
-## MT-PROG-01：技能解锁与使用
+## MT-PROG-01：形态技能与施放
 
-**目的**：验证 `SkillManager` 的技能解锁、技能使用、冷却管理、MP 消耗。
+**目的**：验证 `SkillManager` 的形态技能注入、技能施放、冷却管理、魂力/灵力消耗，以及 `FormSkillPanel`（只读技能一览）的展示。
+
+> **架构说明（务必先读）**
+> - 技能 = `FormSkillSO` 资产，**不通过技能点解锁**。每个形态绑定 3 个技能槽：魂技（`soulSkill`）+ 灵技1（`spiritSkill1`）+ 灵技2（`spiritSkill2`）。
+> - `FormController` 在切换形态时回调 `SkillManager.UpdateSkillSet(...)`，把当前形态的三个技能注入到输入槽。玩家无须"学习"技能，切到该形态即可用。
+> - 施放消耗的是**魂力（SoulPower）或灵力（SpiritPower）**（由 `FormSkillSO.resourceType` 决定），不是 MP。
+> - `FormSkillPanel`（形态技能一览面板）只是只读一览：翻页查看各形态的技能图标/名称/描述/消耗/冷却，**没有解锁交互、没有技能点、没有节点**。
+> - 技能数值可被护符改写，见 MT-PROG-02 与 `SkillModifierRegistry`。
 
 > **🔧 资源准备**
-> 1. 确认 `SkillTree.asset` 已绑定到 `SkillManager._skillTree` 字段
-> 2. 在 Inspector 中直接将 `SkillManager._skillPoints` 设为 5（Play Mode 下修改字段值）快速获取技能点（跳过进程解锁流程）
-> 3. 若 `SkillManager` 不在场景中，手动在空 GameObject 上挂载 `SkillManager` 组件并绑定 `SkillTree.asset`
+> 1. 确认 Player 上 `SkillManager._formSkillSets` 已为待测形态填好三个 `FormSkillSO`。
+> 2. 若待测形态尚未解锁（地魂/命魂），先解锁其形态能力：编辑 `PlayerConfigSO.InitialAbilities` 勾选 `FormDiHun` / `FormMingHun`，或临时写 Editor 脚本调用 `PlayerStats.UnlockAbility(AbilityType.FormDiHun)`。天魂（`FormTianHun`）默认初始解锁。
+> 3. 确认输入动作已绑定：魂技 = `SoulSkillEvent`，灵技1 = `SpiritSkill1StartedEvent`，灵技2 = `SpiritSkill2StartedEvent`（见 `InputReaderSO`）。
 
 ### 步骤
 
-**步骤 A：技能解锁**
+**步骤 A：形态切换注入技能**
 
-1. 打开技能树 UI（默认 P 键）
-2. 确认有足够的技能点（`SkillPoints > 0`）
-3. 点击未解锁的技能节点，确认解锁
+1. 进入 Play Mode，通过 `FormController` 切换到目标形态（切换输入键，或 Inspector 下调用 `FormController.SwitchForm(FormType.XXX)`）。
+2. 观察 `SkillManager` 的当前技能（`SoulSkill` / `Spirit1` / `Spirit2` 属性）。
 
 **预期**：
-- 技能节点视觉变为已解锁状态
-- `SkillPoints - skillCost`
-- `SkillManager.IsUnlocked(skillId) == true`
-- 技能快捷键绑定生效
+- 切换形态后，`SkillManager` 的三个技能引用更新为该形态 `_formSkillSets` 中配置的技能。
+- 冷却字典 `_cooldowns` 重建并清零（切换后立即可施放）。
+- 若切换的是未解锁形态，`FormController.SwitchForm` 被 `HasAbility(FormXXX)` 拦截，技能集不变。
 
-**步骤 B：技能使用（主动技能）**
+**步骤 B：技能施放**
 
-1. 进入 Play Mode 战斗场景
-2. 按已绑定技能快捷键（如 1/2/3 或 Q/E/R）
+1. 进入战斗场景，按魂技/灵技1/灵技2 输入键。
 
 **预期**：
-- 技能动画播放（`AnimancerComponent` 播放技能动画片段）
-- MP 消耗（`CurrentMP -= mpCost`）
-- 技能效果触发（伤害、范围、特效）
-- 进入冷却（`cooldown` 秒内无法再次使用）
+- 技能动画播放（`AnimancerComponent.Play(castAnimation)`）。
+- 资源扣减：`SoulPower`/`SpiritPower -= effectiveCost`（`PlayerStats.ConsumeSoulPower/ConsumeSpiritPower`）。
+- 命中判定生成（若技能配了 `SkillHitBoxPrefab`，从对象池取实例并 `Activate`）。
+- 进入冷却（`effectiveCooldown` 秒内再次按键无效）。
+- 触发 `skill_cast` 反馈预设。
 
-**步骤 C：MP 不足时**
+**步骤 C：资源不足时**
 
-1. 使 `CurrentMP < skill.mpCost`
-2. 按技能键
+1. 使当前魂力/灵力 < `effectiveCost`（可在 Inspector 消耗资源或调小上限）。
+2. 按技能键。
 
-**预期**：技能无法释放，UI 技能图标显示 MP 不足提示（灰色）。
+**预期**：`ConsumeXxxPower` 返回 false，技能不释放（无动画、无判定、不进冷却）。
 
 **步骤 D：技能冷却**
 
-1. 使用技能后立即再次按技能键
+1. 施放技能后立即再次按同一技能键。
 
-**预期**：冷却期内不触发，UI 冷却进度条显示。
+**预期**：冷却期内 `_cooldowns[skill] > 0`，不触发；HUD 冷却指示（`SoulCooldownRatio`）显示剩余比例。
+
+**步骤 E：FormSkillPanel 只读一览**
+
+1. 打开技能一览面板（`FormSkillPanel`）。
+2. 左右翻页浏览各形态，确认当前实际形态被高亮（`_activeFormIndicator`）。
+
+**预期**：面板展示各形态三技能的图标/名称/描述/消耗/冷却；**无任何"解锁/锁定"状态或点击解锁交互**（纯查看）。
 
 | 检查点 | 期望 | ✓ |
 |--------|------|---|
-| 解锁技能 | 技能节点标记已解锁，SkillPoints 减少 | ☐ |
-| 技能释放 | 动画播放，效果触发，MP 扣减 | ☐ |
-| MP 不足 | 无法释放，UI 提示 | ☐ |
-| 冷却 | 冷却期无法再次使用，进度条显示 | ☐ |
+| 形态注入 | 切换形态后 SkillManager 三技能引用随之更新 | ☐ |
+| 未解锁形态拦截 | 切到未解锁形态被 HasAbility 拦截 | ☐ |
+| 技能施放 | 动画播放，判定生成，魂力/灵力扣减 | ☐ |
+| 资源不足 | 无法释放，不进冷却 | ☐ |
+| 冷却 | 冷却期无法再次使用，比例显示 | ☐ |
+| 一览面板 | 只读展示各形态技能，无解锁交互 | ☐ |
 
 ---
 
@@ -205,7 +221,7 @@
 **预期**：
 - `EVT_QuestCompleted` 事件触发
 - 任务移入"已完成"列表
-- 奖励自动发放（Geo/技能点/道具）
+- 奖励自动发放（Geo/能力解锁/道具）
 - 存档文件中 `SaveData.Quests[questId].IsCompleted == true`
 
 | 检查点 | 期望 | ✓ |
@@ -299,7 +315,7 @@
 
 ## MT-PROG-06：能力解锁（AbilityUnlock）
 
-**目的**：验证特殊能力（DoubleJump、WallSlide、Dash 等）的解锁与 `AbilityGate` 联动。
+**目的**：验证特殊能力（DoubleJump、WallCling、Dash 等 `AbilityType` 位）的解锁与 `AbilityGate` 联动。
 
 ### 步骤
 
@@ -308,9 +324,9 @@
 3. 触发解锁
 
 **预期**：
-- `EVT_AbilityUnlocked(abilityId)` 触发
-- `SkillManager.HasAbility(abilityId) == true`
-- 存档中 `SaveData.Abilities` 包含该 abilityId
+- `EVT_AbilityUnlocked(AbilityType)` 触发（`AbilityTypeEventChannelSO`，payload 为解锁的能力位）
+- `PlayerStats.HasAbility(ability) == true`（位掩码 `_unlockedAbilities |= ability`）
+- 存档中 `SaveData.Player.AbilityFlags` 含该能力位（`(uint)_unlockedAbilities`）
 - 对应 `AbilityGate` 自动开启（若当前场景有联动门）
 
 4. 测试新解锁的能力（如 DoubleJump：跳跃后再次跳跃）
@@ -320,7 +336,7 @@
 | 检查点 | 期望 | ✓ |
 |--------|------|---|
 | 解锁事件 | EVT_AbilityUnlocked 触发 | ☐ |
-| HasAbility == true | SkillManager 返回 true | ☐ |
+| HasAbility == true | PlayerStats.HasAbility 返回 true | ☐ |
 | AbilityGate 开启 | 对应能力门自动开启 | ☐ |
 | 能力可用 | 新能力实际可使用 | ☐ |
-| 持久化 | 存档中有该 abilityId | ☐ |
+| 持久化 | 存档 AbilityFlags 含该能力位 | ☐ |