diff --git a/.trae/skills/switch-model/SKILL.md b/.trae/skills/switch-model/SKILL.md index 241a121..4823a6f 100644 --- a/.trae/skills/switch-model/SKILL.md +++ b/.trae/skills/switch-model/SKILL.md @@ -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**: 确保大模型切换时快速同步上下文,按角色差异化加载 +**Purpose**: 确保大模型切换时快速同步上下文,按角色差异化加载 +**Changes from v1.0**: +- 新增安全检查步骤,git 状态优先于上下文加载 +- 增加异常处理(未提交变更/合并冲突/分支错误/远程更新)