---
name: "switch-model"
description: "Checks project context when switching AI models. Invoke when user says '切换模型 架构/开发/测试' or 'switch-model arch/dev/qa'."
---

# 切换模型 Skill

## 功能

当用户更换大模型（Claude/TRAE/扣子/元宝等）时，快速加载项目上下文，确保新模型理解当前状态并遵循规则。

## 触发条件

**必须指定角色**：
- `切换模型 架构` / `switch-model arch` → Arch AI
- `切换模型 开发` / `switch-model dev` → Dev AI
- `切换模型 测试` / `switch-model qa` → QA AI

**不指定角色时**：询问用户，不执行全面检查。

## 执行步骤

### 1. 识别角色

| 触发词 | 角色 | 配置文件 |
|--------|------|---------|
| 架构/arch | Arch AI | .ai/config/architect.json |
| 开发/dev/coder | Dev AI | .ai/config/coder.json |
| 测试/test/qa | QA AI | .ai/config/tester.json |

### 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. 按角色加载专属上下文

#### Arch AI（架构AI）

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

#### Dev AI（编码AI）

```
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）

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

### 5. 输出简洁检查报告

```markdown
# 模型切换检查报告

## 角色确认
- 当前角色: [角色名]
- 权限: [可写路径] | 只读: [只读路径] | 禁止: [禁止路径]

## 项目状态
- 当前阶段: [工作流阶段]
- 活跃任务: [任务编号和名称]
- 工作区: [干净/有变更]

## 最近提交 (3 条)
- [commit 1]
- [commit 2]
- [commit 3]

## 待办事项
- [ ] [待办 1]
- [ ] [待办 2]

## 阻塞点
- [无 / 具体问题]

✅ 已就绪，等待指令
```

### 6. 等待用户指令

报告输出后，等待用户进一步指令。用户可以说：
- `展开 [某项]` → 深入查看细节
- `开始工作` → 进入角色模式
- `切换角色` → 重新执行本 Skill

## 注意事项

1. **必须指定角色**：不指定时询问用户，不盲目全面检查
2. **简洁优先**：报告控制在 1 屏内，用户需要细节时可展开
3. **权限意识**：加载配置后立即确认权限边界
4. **不修改文件**：此 Skill 只读取上下文，不修改任何文件
5. **Skill 列表**：确保新模型知道有哪些 Skill 可用

---

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