docs(enemy): Task 21 补 Step 2.5——处理描述已删除系统的长期文档
Task 19 发现约 20 份文档仍在描述旧 Boss 轨,含两份整份失效的架构/设计文档。 按第 7 条,Docs/ 是长期文档,留着描述不存在的类型比没有更糟。 分类处理:两份整份删除、AssetFolderSpec 局部修订、Guides 随新章节改写、 Docs_Dev 的历史记录保留不动(那是过程记录,改了反而失真)。
This commit is contained in:
@@ -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 怎么写」,内容覆盖:
|
||||
|
||||
Reference in New Issue
Block a user