docs(enemy): Task 21 补 Step 2.5——处理描述已删除系统的长期文档

Task 19 发现约 20 份文档仍在描述旧 Boss 轨,含两份整份失效的架构/设计文档。
按第 7 条,Docs/ 是长期文档,留着描述不存在的类型比没有更糟。
分类处理:两份整份删除、AssetFolderSpec 局部修订、Guides 随新章节改写、
Docs_Dev 的历史记录保留不动(那是过程记录,改了反而失真)。
This commit is contained in:
2026-07-30 16:47:51 +08:00
parent ad41da0410
commit 2c569dcf0d
@@ -2958,6 +2958,22 @@ grep -rn "BossSkill\|WeakPoint\|Telegraph\|AttackPattern\|SkillSequence\|StopBeh
必须加 `[UnityEngine.Serialization.FormerlySerializedAs("_maxActiveBehaviorTrees")]`
再改为 `_maxActiveBrains`(该管理器实际裁剪的是 `EnemyAiBrain`,不是能力组件)。
- [ ] **Step 2.5: 处理描述已删除系统的长期文档(Task 19 发现)**
约 20 份 `Docs/``Docs_Dev/` 文档仍在描述旧 Boss 轨。按 CLAUDE.md 第 7 条,
`Docs/` 是需要长期维护、对项目持续有效的文档——留着整份描述已不存在系统的架构文档,
比没有文档更糟(新人会照着它去找不存在的类型)。逐类处理:
| 文档 | 处理 |
|---|---|
| `Docs/Architecture/23_BossSkillModule.md` | 整份描述已删除的 `BossSkillSO`/`BossSkillExecutor` 体系 → **删除**,其内容已被本次 spec 取代 |
| `Docs/Design/47_BossSkillSystem.md` | 同上 → **删除** |
| `Docs/Standards/AssetFolderSpec.md` | 只需删掉旧 Boss 技能资产的条目,其余规范仍有效 → **局部修订** |
| `Docs/Guides/` 下提到旧轨的章节 | 随 Step 3 的新章节一并改写 |
| `Docs_Dev/` 下的历史计划与验证清单 | **保留不动**——那是开发过程记录,反映当时状态,改了反而失真 |
删除前确认没有其他文档以链接方式引用它们;若有,把链接指向本次的 spec。
- [ ] **Step 3: 更新指导手册**
`Docs/Guides/` 的敌人 / Boss 章节新增一节「Boss AI 怎么写」,内容覆盖: