diff --git a/.claude/commands/envoy.md b/.claude/commands/envoy.md
index c3e6f88..eca28e4 100644
--- a/.claude/commands/envoy.md
+++ b/.claude/commands/envoy.md
@@ -14,6 +14,8 @@
 回顾本次会话的完整对话，识别有价值的洞察。
 跳过：纯代码实现细节、具体 bug 修复、一次性操作记录。
 
+> ⚠️ **炼境定位讨论不得漏判**：凡涉及「炼境自身定位 / 缺口 / 演进方向 / 与其他工具的对比」的讨论，即便看起来像聊天而非技术实现，**默认视为体系级洞察，列入带回候选清单**。此类内容在历史会话中曾被漏传（判定为聊天），经用户追问才补发。
+
 ## Step 3：分类每条洞察
 
 **前置硬门槛（先于一切分类判断）**：问自己——**任何有经验的工程师是否会提前想到这一点？**
@@ -34,6 +36,8 @@
 ## Step 4：发回炼境
 
 对每条「带回」洞察，单独调用一次 `mcp__lian-jing__append_project_note`。
+
+> **MCP 不可用时的降级**：若 `mcp__lian-jing__append_project_note` 报连接错误，重试 1~2 次仍失败，则将所有待回传内容按 Step 4 格式整理成一段文本，输出到对话让用户看到，并提示：「MCP 断连，请复制以上内容到炼境会话手动执行 `/envoy` 回传，或重连后重跑本命令」。
 - `project_id`：来自 Step 1
 - `content` 格式（严格遵守）：
 
diff --git a/src-tauri/resources/onboarding/.claude/commands/envoy.md b/src-tauri/resources/onboarding/.claude/commands/envoy.md
index 19d07a7..59d9eec 100644
--- a/src-tauri/resources/onboarding/.claude/commands/envoy.md
+++ b/src-tauri/resources/onboarding/.claude/commands/envoy.md
@@ -16,6 +16,8 @@
 回顾本次会话的完整对话，识别有价值的洞察。
 跳过：纯代码实现细节、具体 bug 修复、一次性操作记录。
 
+> ⚠️ **炼境定位讨论不得漏判**：凡涉及「炼境自身定位 / 缺口 / 演进方向 / 与其他工具的对比」的讨论，即便看起来像聊天而非技术实现，**默认视为体系级洞察，列入带回候选清单**。此类内容在历史会话中曾被漏传（判定为聊天），经用户追问才补发。
+
 ## Step 3：分类每条洞察
 
 **前置硬门槛（先于一切分类判断）**：问自己——**任何有经验的工程师是否会提前想到这一点？**
@@ -36,6 +38,8 @@
 ## Step 4：发回炼境
 
 对每条「带回」洞察，单独调用一次 `mcp__lian-jing__append_project_note`。
+
+> **MCP 不可用时的降级**：若 `mcp__lian-jing__append_project_note` 报连接错误，重试 1~2 次仍失败，则将所有待回传内容按 Step 4 格式整理成一段文本，输出到对话让用户看到，并提示：「MCP 断连，请复制以上内容到炼境会话手动执行 `/envoy` 回传，或重连后重跑本命令」。
 - `project_id`：来自 Step 1
 - `content` 格式（严格遵守）：