scene-capability-engine 3.3.18 → 3.3.22

package/template/.sce/steering/CORE_PRINCIPLES.md

@@ -102,6 +102,19 @@
 
 **后果**: 违反导致用户困惑、功能难发现、门槛高、维护成本增
 
+### 8.1 Git 托管强制门禁原则 🔐
+
+**核心**: 新增或修改代码必须进入 Git 托管管理链路，禁止“本地改完未推送”进入发布流程
+
+**默认强制**: 若仓库配置了 GitHub/GitLab 远端，发布前必须满足：
+1) 工作区干净（无未提交变更）  
+2) 当前分支已配置 upstream  
+3) 与 upstream 完全同步（ahead=0, behind=0）
+
+**豁免条件**: 仅当客户环境确实没有 GitHub/GitLab 托管时允许放行（策略控制），并需在交付记录中声明原因
+
+**落地门禁**: `scripts/git-managed-gate.js`（`prepublishOnly` 与 release preflight 默认执行）
+
 ### 9. 版本同步和 Steering 刷新原则
 
 **核心**: 版本更新或首次安装后，必须阅读 `.sce/README.md` 并刷新 Steering
@@ -134,6 +147,15 @@
 
 **硬规则**: ❌ 禁止通过关闭校验、跳过测试、降级关键路径、屏蔽异常等方式“假修复”
 
+**失败显式原则**: 核心路径禁止吞错继续。无法确认安全修复时，必须 `fail-fast + 明确告警`，不得用静默回退伪装成功
+
+**兜底治理原则**: 允许临时兜底仅用于止血，不得替代根因修复；临时兜底必须结构化记录：
+1) 退出条件（exit criteria）  
+2) 清理任务（cleanup task/spec）  
+3) 截止时间（deadline）
+
+**发布门禁**: 若存在临时兜底但缺少上述治理信息，或已超过截止时间未清理，默认阻断发布（`errorbook release-gate`）
+
 **复杂问题定位方法**: 优先使用 debug 日志与可观测信号定位（输入、输出、关键分支、异常栈、上下文参数），先还原执行路径再下结论
 
 **修复后清理要求**: 问题修复并验证通过后，必须清理临时 debug 日志、临时埋点、一次性脚本和调试开关；需要长期保留的日志必须转为可配置观测项且默认关闭
@@ -155,6 +177,18 @@
 
 **要求**: 需求分析、问题定位、模板沉淀、发布门禁均按该口径检查完整性与一致性
 
+### 13. Scene 主会话强制治理原则 🎛️
+
+**核心**: SCE 默认并强制采用 `1 Scene = 1 主会话`，会话生命周期由 Scene 驱动而不是由单个 Agent 的原生 session 决定
+
+**硬规则**:
+1) `studio plan` 必须提供 `--scene`，并绑定 Scene 主会话  
+2) 同一 Scene 同时只允许一个活动主会话  
+3) `Spec` 必须作为该 Scene 主会话下的子会话管理（创建、归档、摘要回写）  
+4) Scene 完成（如 release 成功）后，当前主会话自动归档，并自动开启下一周期主会话
+
+**目标**: 保证跨 Agent 连续性、可追溯历史、上下文可控，避免因 Agent session 长短差异导致上下文漂移
+
 ---
 
-v16.0 | 2026-02-25 | 新增调试日志清理硬规则
+v18.0 | 2026-02-27 | 强化根因修复与临时兜底发布门禁原则