From 2c569dcf0dd89239aaa47a54bddf4310168bb4a1 Mon Sep 17 00:00:00 2001 From: Joywayer Date: Thu, 30 Jul 2026 16:47:51 +0800 Subject: [PATCH] =?UTF-8?q?docs(enemy):=20Task=2021=20=E8=A1=A5=20Step=202?= =?UTF-8?q?.5=E2=80=94=E2=80=94=E5=A4=84=E7=90=86=E6=8F=8F=E8=BF=B0?= =?UTF-8?q?=E5=B7=B2=E5=88=A0=E9=99=A4=E7=B3=BB=E7=BB=9F=E7=9A=84=E9=95=BF?= =?UTF-8?q?=E6=9C=9F=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Task 19 发现约 20 份文档仍在描述旧 Boss 轨，含两份整份失效的架构/设计文档。 按第 7 条，Docs/ 是长期文档，留着描述不存在的类型比没有更糟。 分类处理：两份整份删除、AssetFolderSpec 局部修订、Guides 随新章节改写、 Docs_Dev 的历史记录保留不动（那是过程记录，改了反而失真）。 --- .../plans/2026-07-30-boss-ai-single-track.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md b/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md index c92a0367..60f68805 100644 --- a/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md +++ b/Docs_Dev/superpowers/plans/2026-07-30-boss-ai-single-track.md @@ -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 怎么写」，内容覆盖：