feat(ai): 新增 IBossControl facet——Boss 阶段状态经 IAiContext 供图读取

非 Boss 敌人访问 IAiContext.Boss 显式抛 InvalidOperationException，
不返回空对象掩盖小怪图误挂 Boss 边的错误。BossResource 补 IsFull 供图条件边判定。

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

Assets/_Game/Scripts/Enemies/AIBrain/EnemyBrainContext.cs

@@ -1,3 +1,4 @@
+using System;
 using UnityEngine;
 using BaseGames.AI;
 
@@ -10,11 +11,16 @@ namespace BaseGames.Enemies
     public sealed class EnemyBrainContext : IAiContext, ISensor, ICombatant, IActorVitals, IEnemyActor
     {
         readonly EnemyBase _enemy;
+        readonly BossBase  _boss;
         readonly Blackboard _blackboard = new Blackboard();
         Vector2 _lastKnown;
         float _lostTimer;
 
-        public EnemyBrainContext(EnemyBase enemy) { _enemy = enemy; }
+        public EnemyBrainContext(EnemyBase enemy)
+        {
+            _enemy = enemy;
+            _boss  = enemy as BossBase;   // 非 Boss 为 null，Boss facet 访问时显式抛
+        }
 
         // ---- IAiContext ----
         public ISensor Sensor => this;
@@ -23,6 +29,14 @@ namespace BaseGames.Enemies
         public IActorVitals Vitals => this;
         public Blackboard Blackboard => _blackboard;
 
+        /// <summary>
+        /// Boss 专属决策面。非 Boss 敌人访问即抛——小怪图误挂了 Boss 边必须立刻暴露，
+        /// 不返回空对象让错误静默通过（CLAUDE.md 第 6 条）。
+        /// </summary>
+        public IBossControl Boss => _boss ?? throw new InvalidOperationException(
+            $"[EnemyBrainContext] '{_enemy.name}' 不是 Boss（未挂 BossBase 或其子类），" +
+            "但它的 AI 图访问了 IAiContext.Boss。请检查该敌人是否误用了 Boss 专属的图或图片段。");
+
         /// <summary>每帧由 EnemyAiBrain 在 Tick 之前调用，维护最后已知位置与丢失计时（供需要的敌人用）。</summary>
         public void Refresh(float dt)
         {

Assets/_Game/Scripts/Enemies/Boss/BossBase.cs

@@ -12,7 +12,7 @@ namespace BaseGames.Enemies
     /// Boss 敌人基类。扩展 <see cref="EnemyBase"/> 以支持多阶段切换、技能执行与战斗结束广播。
     /// 具体 Boss 继承此类并重写 <see cref="EnterPhase"/>。
     /// </summary>
-    public class BossBase : EnemyBase
+    public class BossBase : EnemyBase, BaseGames.AI.IBossControl
     {
         [Header("Boss 配置")]
         [SerializeField] private string                    _bossId;
@@ -31,12 +31,15 @@ namespace BaseGames.Enemies
 
         public string BossId => _bossId;
 
-        /// <summary>当前是否有 Boss 技能正在执行（BD_UseBossSkill 轮询此值）。</summary>
+        /// <summary>当前是否有 Boss 技能正在执行。</summary>
         public bool IsBossSkillExecuting => _skillExecutor != null && _skillExecutor.IsExecuting;
 
         protected int _currentPhase = 0;
-        /// <summary>当前 Boss 阶段索引（BD Task 可直接查询）。</summary>
+        /// <summary>当前 Boss 阶段索引。IBossControl 实现。</summary>
         public int CurrentPhase => _currentPhase;
+
+        /// <summary>Boss 资源是否已满（未挂资源组件时恒为 false）。IBossControl 实现。</summary>
+        public bool ResourceFull => _bossResource != null && _bossResource.IsFull;
         private Coroutine _counterStaggerCoroutine;
 
         // 缓存加权候选与其有效权重（两者等长、下标对应），避免 UseBossSkillWeighted() 每次 new List → GC 分配

Assets/_Game/Scripts/Enemies/Boss/BossResource.cs

@@ -26,6 +26,10 @@ namespace BaseGames.Boss
         public float NormalizedValue => _config != null && _config.maxValue > 0f
             ? _currentValue / _config.maxValue : 0f;
 
+        /// <summary>资源是否已达上限（供 AI 图条件边判定"可放大招"）。</summary>
+        public bool IsFull => _config != null && _config.maxValue > 0f
+                              && _currentValue >= _config.maxValue;
+
         private void Awake()
         {
             if (_boss == null) _boss = GetComponentInParent<BossBase>();