feat(roundtable): 会商席位「技能识别强化」改为按需开关(智能体级 + 链条每席位级)

弱模型补偿指令从全域生效改为默认关闭、两个 opt-in 开关取 OR:
- 智能体级: AgentConfig.seat_skill_directive(config.yaml),在智能体编辑弹窗
  (agent-card / agent-detail-panel)开关;agents 路由 create/update/读写全程穿。
- 业务链条每席位级: 存进链条 seats JSON(ChainSeatSchema.seat_skill_directive,
  无需 DB 列/迁移),在链条编辑器每个席位卡片右侧 ✨ 图标→下拉框(开关+说明)配置;
  按 agentId 查表穿到前台 useStep2Orchestration 各席位调用 + 后台作业
  seat_skill_directives:{agentId:bool} → InProcessRoundtableGateway.run_seat。
- ROUNDTABLE_SEAT_SKILL_DIRECTIVE 降级为总熔断开关(默认放行,不再 force-on)。

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

offline-backend-20260512/backend/app/gateway/roundtable_seat_skills.py

@@ -11,12 +11,20 @@
 强得多——这与本仓已有的弱模型补偿手法（``_SEAT_NO_ASK``、总控派活强化、AI 写作 SKILL.md
 注入，见 ``project-ai-writing-skill-agent``）一脉相承。
 
+**默认关闭、按需开启（2026-06-20 改造）**：不再全域生效。是否对某席位注入由两个开关
+取 **OR** 决定——
+  1. **智能体级**：该席位 agent 的 ``config.yaml → seat_skill_directive``（智能体编辑页
+     可开关）；
+  2. **业务链条级**：本次会商所选业务链条的同名开关，由调用方读出后以 ``chain_enabled``
+     传入（前端手动与后台挂起两条路径都按席位透传）。
+任一为真即注入；两者都假 → 返回空串、原样使用任务文本（零副作用）。
+
 两条席位执行路径共用本 helper：
   - 前端手动：``multi_agent._special_run``（seat / seat_parallel 角色）；
   - 后台挂起：``roundtable_inprocess_gateway.InProcessRoundtableGateway.run_seat``。
 
-无配置技能的席位 → 返回空串（完全无副作用）。可用 ``ROUNDTABLE_SEAT_SKILL_DIRECTIVE=0``
-全局关闭（默认开）。
+``ROUNDTABLE_SEAT_SKILL_DIRECTIVE`` 仅作**总开关（kill-switch）**：默认放行，显式设为
+0/false 时彻底关闭本功能（不论两个开关如何），用于线上一键熔断。它**不再** force-on。
 """
 
 from __future__ import annotations
@@ -27,25 +35,36 @@ import os
 logger = logging.getLogger(__name__)
 
 _TRUTHY = frozenset({"1", "true", "yes", "on", "y"})
+_FALSY = frozenset({"0", "false", "no", "off", "n"})
 
 
-def _directive_enabled() -> bool:
-    """读 ``ROUNDTABLE_SEAT_SKILL_DIRECTIVE``（默认开）。空 / 未设 = 开。"""
-    return (os.getenv("ROUNDTABLE_SEAT_SKILL_DIRECTIVE") or "1").strip().lower() in _TRUTHY
+def _master_enabled() -> bool:
+    """``ROUNDTABLE_SEAT_SKILL_DIRECTIVE`` 总开关：默认放行（kill-switch）。
+
+    空 / 未设 / 非法 = 放行；仅显式 0/false/no/off/n 时整体关闭。注意它**只熔断不强开**，
+    具体是否注入仍由 agent / chain 两个开关取 OR 决定。
+    """
+    return (os.getenv("ROUNDTABLE_SEAT_SKILL_DIRECTIVE") or "").strip().lower() not in _FALSY
 
 
-def build_seat_skill_directive(agent_id: str | None) -> str:
+def build_seat_skill_directive(agent_id: str | None, *, chain_enabled: bool = False) -> str:
     """为某席位 agent 构建「必须先读 SKILL.md 再用技能」的本轮任务追加指令。
 
-    返回 ``""`` 表示无需追加（开关关闭 / 无 agent_id / 该席位没有配置技能 / 解析失败），
-    调用方原样使用任务文本，零副作用。
+    是否注入由 **agent 开关（config.yaml）OR chain 开关（``chain_enabled``）** 决定，
+    默认两者皆关 → 不注入。返回 ``""`` 表示无需追加（总开关熔断 / 两开关都关 / 无 agent_id /
+    该席位没有配置技能 / 解析失败），调用方原样使用任务文本，零副作用。
     """
-    if not _directive_enabled() or not agent_id:
+    if not _master_enabled() or not agent_id:
         return ""
     try:
         from deerflow.config.agents_config import load_agent_config
 
         cfg = load_agent_config(agent_id)
+        # agent 级开关 OR chain 级开关（默认关）。任一打开才继续，否则零副作用返回。
+        agent_enabled = bool(cfg and cfg.seat_skill_directive)
+        if not (agent_enabled or chain_enabled):
+            return ""
+
         configured = [name for name in (cfg.skills or []) if name] if cfg else []
         if not configured:
             return ""
@@ -87,9 +106,12 @@ def build_seat_skill_directive(agent_id: str | None) -> str:
         return ""
 
 
-def append_seat_skill_directive(agent_id: str | None, task: str) -> str:
-    """把技能识别指令追加到席位本轮任务文本后（无指令时原样返回）。"""
-    directive = build_seat_skill_directive(agent_id)
+def append_seat_skill_directive(agent_id: str | None, task: str, *, chain_enabled: bool = False) -> str:
+    """把技能识别指令追加到席位本轮任务文本后（无指令时原样返回）。
+
+    ``chain_enabled``：本次会商所选业务链条是否打开「技能识别强化」。与 agent 级开关取 OR。
+    """
+    directive = build_seat_skill_directive(agent_id, chain_enabled=chain_enabled)
     if not directive:
         return task
     return f"{task}\n\n---\n\n{directive}"