Files
ai_soc_sw/.trae/skills/resume-context/SKILL.md
T

196 lines
4.9 KiB
Markdown
Raw Normal View History

---
name: "resume-context"
description: "Loads project context and syncs conversation history. Invoke when user switches computers, starts a new session, or says '接着干 开发'、'接着干 测试'、'接着干 架构'."
---
# 接着干 - 上下文同步 Skill
## 功能
当用户更换电脑、开启新会话、或说"接着干"时,自动读取项目上下文文档,恢复之前的开发状态和讨论背景,并根据用户指定的角色设定 AI 权限。
## 触发条件
用户必须使用以下格式之一:
| 触发词 | 角色 | 权限 |
|--------|------|------|
| `接着干 开发` | Dev AI | 按宪法约束(coder.json |
| `接着干 测试` | QA AI | 按宪法约束(tester.json |
| `接着干 架构` | 人类负责人 | 最高权限,不受宪法约束 |
**别名**`继续 开发/测试/架构``resume dev/test/arch`
## 执行步骤
### 1. 识别角色
根据用户输入的后缀词判断角色:
```
开发/dev/coder → Dev AI
测试/test/qa → QA AI
架构/arch → Arch AI(架构设计师)
```
### 2. 读取项目上下文
按以下顺序读取核心文档:
```
1. docs/PROJECT_CONTEXT.md # 项目整体上下文
2. docs/DECISIONS.md # 关键决策记录
3. docs/06_开发日志/ # 最新开发日志(按日期倒序)
4. AGENTS.md # AI 角色和权限约定
```
### 3. 加载角色配置
根据识别的角色,读取对应的配置文件:
**Arch AI**
```
.ai/config/architect.json
```
- 读取 `allowed_paths``read_only_paths``forbidden_paths`
- 读取 `responsibilities`
- 读取 `prompt_templates`
- **拥有最高 AI 权限**,可以进行架构设计和跨模块修改
**Dev AI**
```
.ai/config/coder.json
```
- 读取 `allowed_paths``read_only_paths``forbidden_paths`
- 读取 `responsibilities`
- 读取 `prompt_templates`
**QA AI**
```
.ai/config/tester.json
```
- 读取 `allowed_paths``read_only_paths``forbidden_paths`
- 读取 `responsibilities`
- 读取 `prompt_templates`
### 4. 读取最新开发日志
```powershell
# 获取最新的开发日志文件
Get-ChildItem "docs/06_开发日志/" -Filter "*.md" | Sort-Object Name -Descending | Select-Object -First 3
```
读取最近 3 篇日志,了解最近的讨论内容。
### 5. 同步状态
向用户报告当前状态和角色:
```markdown
## 上下文同步完成
### 当前角色
- **角色**: [Dev AI / QA AI / 人类负责人]
- **权限**: [按宪法约束 / 最高权限]
- **可写路径**: [列出 allowed_paths]
- **只读路径**: [列出 read_only_paths]
### 项目状态
- **当前阶段**: [从 PROJECT_CONTEXT.md 读取]
- **最新任务**: [从 review/active/ 读取最新任务]
- **最近工作**: [从最新开发日志读取]
### 待办事项
- [从 PROJECT_CONTEXT.md 和开发日志中提取]
### 可以继续的工作
- [列出可以继续开发的任务]
```
### 6. 确认用户意图
询问用户:
- 继续上次未完成的工作?
- 开始新的任务?
- 查看项目状态?
## 文档格式要求
### PROJECT_CONTEXT.md
```markdown
# 项目上下文
## 项目愿景
[一句话描述项目目标]
## 当前阶段
[当前处于哪个阶段,已完成什么]
## 技术栈
[主要技术选型]
## 团队架构
[1 人 + 2AI 协作模式]
## 关键决策
[列出重要决策和原因]
## 待解决问题
[列出悬而未决的问题]
## 下一步计划
[接下来的工作重点]
```
### 开发日志格式
```markdown
# YYYY-MM-DD_主题
## 讨论内容
[主要讨论了什么]
## 关键决策
[做出了什么决定]
## 完成的工作
[做了什么改动]
## 待办事项
[接下来要做什么]
```
## 使用场景
**何时调用此 skill**
- ✅ 更换电脑后开始工作
- ✅ 开启新会话,需要恢复上下文
- ✅ 长时间未开发,需要回忆项目状态
- ✅ 用户说"接着干 开发/测试/架构"
**不适用场景:**
- ❌ 首次启动项目(应使用 ai-collab-setup
- ❌ 只需要查看代码(直接搜索即可)
## 注意事项
1. **角色必须明确**:用户必须指定"开发"、"测试"或"架构",否则询问用户
2. **架构模式**:架构模式对应 Arch AI,拥有最高 AI 权限,可以进行架构设计和跨模块修改
3. **不要修改文档**:此 skill 只读取上下文,不修改任何文件(除非用户明确要求)
4. **关注最新内容**:优先读取最新的开发日志
5. **识别阻塞点**:注意 PROJECT_CONTEXT.md 中的"待解决问题"
6. **权限意识**:开发/测试/架构模式下严格遵循 AGENTS.md 中的权限约定
---
**Version**: 3.0
**Created**: 2026-05-23
**Updated**: 2026-05-23
**Based On**: ErrLens AI Programming Project
**Purpose**: 解决用户多电脑切换时的上下文同步问题,明确 AI 角色和权限
**Changes from v2.0**:
- 架构模式从"人类负责人"改为"Arch AI(架构设计师)"
- 新增 .ai/config/architect.json 配置读取
- 支持"1 人+3AI"协作模式