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/AI/IAiContext.cs

@@ -11,5 +11,11 @@ namespace BaseGames.AI
         ICombatant Combat { get; }
         IActorVitals Vitals { get; }
         Blackboard Blackboard { get; }
+
+        /// <summary>
+        /// Boss 专属决策面。**非 Boss 敌人访问本属性会抛 InvalidOperationException**——
+        /// 小怪图误用 Boss 边必须立刻暴露，不返回空对象把问题盖住。
+        /// </summary>
+        IBossControl Boss { get; }
     }
 }

Assets/_Game/Scripts/AI/IBossControl.cs

@@ -0,0 +1,25 @@
+namespace BaseGames.AI
+{
+    /// <summary>
+    /// Boss 专属决策面。挂在 <see cref="IAiContext"/> 上供 Boss 图读取阶段状态、发起阶段过渡、
+    /// 查询竞技场锚点。只暴露"决策需要知道的"，过渡演出与无敌帧由实现方（BossBase）负责。
+    /// 非 Boss 敌人访问 <see cref="IAiContext.Boss"/> 会抛异常——这是有意的显式失败。
+    /// </summary>
+    public interface IBossControl
+    {
+        /// <summary>当前阶段索引（出生为 0）。</summary>
+        int CurrentPhase { get; }
+
+        /// <summary>是否处于阶段过渡（无敌 + 过渡演出）期间。</summary>
+        bool IsPhaseTransitioning { get; }
+
+        /// <summary>Boss 资源是否已满（无资源组件时恒为 false）。</summary>
+        bool ResourceFull { get; }
+
+        /// <summary>发起阶段过渡：无敌 invincibleDuration 秒后切入 targetPhase。</summary>
+        void BeginPhaseTransition(int targetPhase, float invincibleDuration);
+
+        // 竞技场锚点两成员（AnchorAt / DistanceToAnchor）在 Task 10 与
+        // BossArenaAnchors 组件一并加入——此刻加会让 Task 2–8 期间 BossBase 编译不过。
+    }
+}

Assets/_Game/Scripts/AI/IBossControl.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 20ae59ebfd68f04488a369b1c1911040
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

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>();