fix(switch-model): 调整执行顺序，git 安全检查优先

- 将 git status/log/branch 移到上下文加载之前 - 增加异常处理：未提交变更/合并冲突/分支错误/远程更新 - 版本升至 v1.1
2026-05-23 23:02:08 +08:00
parent 5cba5c248a
commit b3fbe33dd0
1 changed files with 44 additions and 23 deletions
@@ -28,49 +28,66 @@ description: "Checks project context when switching AI models. Invoke when user
 | 开发/dev/coder | Dev AI | .ai/config/coder.json |
 | 测试/test/qa | QA AI | .ai/config/tester.json |

-### 2. 加载基础上下文（所有角色通用）
+### 2. 安全检查（git 状态优先）
+
+**必须先检查 git 仓库状态，确保在安全的环境下加载上下文**：
+
+```bash
+git status              # 工作区状态（干净/有变更/有冲突）
+git log --oneline -3    # 最近 3 次提交（了解最近做了什么）
+git branch              # 当前分支（确认是否在正确分支）
+```
+
+**异常处理**：
+
+| 状态 | 处理方式 |
+|------|---------|
+| 工作区有未提交变更 | 提醒用户先提交或暂存，避免上下文不一致 |
+| 有合并冲突 | 立即告知用户需要解决冲突 |
+| 分支不对 | 提醒用户切换到正确分支 |
+| 远程有更新未拉取 | 提醒用户先 pull |
+
+### 3. 加载基础上下文（所有角色通用）

 ```
 1. AGENTS.md                        # 团队架构和权限矩阵
 2. .ai/config/workflow.json         # 工作流配置
 3. docs/PROJECT_CONTEXT.md          # 项目整体状态
-4. git log --oneline -3             # 最近 3 次提交
-5. git status                       # 工作区状态
 ```

-### 3. 按角色加载专属上下文
+### 4. 按角色加载专属上下文

 #### Arch AI（架构AI）

 ```
-6. .ai/config/architect.json        # 角色权限
-7. docs/02_系统架构/                # 架构文档
-8. review/active/*/task.md          # 活跃任务
-9. .trae/skills/                    # 可用 Skill 列表
-10. ENVIRONMENT.md                  # 环境配置
+4. .ai/config/architect.json        # 角色权限
+5. docs/02_系统架构/                # 架构文档
+6. review/active/*/task.md          # 活跃任务
+7. .trae/skills/                    # 可用 Skill 列表
+8. ENVIRONMENT.md                  # 环境配置
 ```

 #### Dev AI（编码AI）

 ```
-6. .ai/config/coder.json            # 角色权限
-7. review/active/*/task.md          # 活跃任务
-8. review/active/*/feedback/        # 待修 Bug
-9. .trae/skills/                    # 可用 Skill 列表
-10. ENVIRONMENT.md                  # 环境配置
+4. .ai/config/coder.json            # 角色权限
+5. review/active/*/task.md          # 活跃任务
+6. review/active/*/feedback/        # 待修 Bug
+7. .trae/skills/                    # 可用 Skill 列表
+8. ENVIRONMENT.md                  # 环境配置
 ```

 #### QA AI（测试AI）

 ```
-6. .ai/config/tester.json           # 角色权限
-7. review/active/*/acceptance.md    # 验收标准
-8. reports/test-results/            # 最近测试报告
-9. .trae/skills/                    # 可用 Skill 列表
-10. ENVIRONMENT.md                  # 环境配置
+4. .ai/config/tester.json           # 角色权限
+5. review/active/*/acceptance.md    # 验收标准
+6. reports/test-results/            # 最近测试报告
+7. .trae/skills/                    # 可用 Skill 列表
+8. ENVIRONMENT.md                  # 环境配置
 ```

-### 4. 输出简洁检查报告
+### 5. 输出简洁检查报告

 ```markdown
 # 模型切换检查报告
@@ -99,7 +116,7 @@ description: "Checks project context when switching AI models. Invoke when user
 ✅ 已就绪，等待指令
 ```

-### 5. 等待用户指令
+### 6. 等待用户指令

 报告输出后，等待用户进一步指令。用户可以说：
 - `展开 [某项]` → 深入查看细节
@@ -116,7 +133,11 @@ description: "Checks project context when switching AI models. Invoke when user

 ---

-**Version**: 1.0  
+**Version**: 1.1  
 **Created**: 2026-05-23  
+**Updated**: 2026-05-23  
 **Based On**: ErrLens AI Programming Project  
 **Purpose**: 确保大模型切换时快速同步上下文，按角色差异化加载  
+**Changes from v1.0**: 
+- 新增安全检查步骤，git 状态优先于上下文加载
+- 增加异常处理（未提交变更/合并冲突/分支错误/远程更新）