From 3957a32efa49fe1c24afe00a7ea1dfff4caf9517 Mon Sep 17 00:00:00 2001 From: Peter Zhang <18501667167@qq.com> Date: Mon, 8 Jun 2026 14:14:55 +0800 Subject: [PATCH] =?UTF-8?q?test:=20=E6=B7=BB=E5=8A=A0=20Agent=20session=20?= =?UTF-8?q?=E4=B8=8A=E4=B8=8B=E6=96=87=E5=8E=8B=E7=BC=A9=E8=A7=84=E5=88=99?= =?UTF-8?q?=20=E2=80=94=20Closes=20#115?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.7 --- .claude/agents/dev-agent.md | 7 +++++++ .claude/agents/qe-agent.md | 7 +++++++ CLAUDE.md | 7 +++++++ agents/DEV_AGENT.md | 7 +++++++ agents/QE_AGENT.md | 7 +++++++ 5 files changed, 35 insertions(+) diff --git a/.claude/agents/dev-agent.md b/.claude/agents/dev-agent.md index f468ee0..2a8ccf5 100644 --- a/.claude/agents/dev-agent.md +++ b/.claude/agents/dev-agent.md @@ -78,6 +78,13 @@ export GITEA_USER=pzhang_dev_agent_01 # Dev-Agent 账号 6. 无 Issue → 报告 "main healthy，无待处理 Issue"，等待下次轮询 7. 同时保持对话开放，随时响应用户指令 +## 上下文管理 +Context window 有限。当 session 持续较长时间时： +1. 根据对话轮次和消息长度估计 context 使用量 +2. **使用量达 ~80% 时主动使用 `/compact` 压缩对话** +3. 压缩时保留：当前 Issue 上下文、`GLOBAL_STATE.md`、`PROJECT_CHARTER.md`、Agent 角色定义 +4. 压缩后从摘要恢复上下文，继续当前任务 + ## 工作流程 ### 1. 轮询 Issue diff --git a/.claude/agents/qe-agent.md b/.claude/agents/qe-agent.md index aee6574..d8149ff 100644 --- a/.claude/agents/qe-agent.md +++ b/.claude/agents/qe-agent.md @@ -31,6 +31,13 @@ description: "document_analyzer QE-Agent: 自动化验收测试开发与质量 这样 QE-Agent 真正做到 **"默认轮询 + 随时互动"**。 +## 上下文管理 +Context window 有限。当 session 持续较长时间时： +1. 根据对话轮次和消息长度估计 context 使用量 +2. **使用量达 ~80% 时主动使用 `/compact` 压缩对话** +3. 压缩时保留：当前 Issue 上下文、`GLOBAL_STATE.md`、`PROJECT_CHARTER.md`、Agent 角色定义 +4. 压缩后从摘要恢复上下文，继续当前任务 + ## 环境要求 开始工作前，确认以下环境变量已设置： diff --git a/CLAUDE.md b/CLAUDE.md index ac1b306..ae28e88 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -13,6 +13,13 @@ 4. **质量级修复必须跑 pipeline + e2e**，pytest 绿了不等于功能正确 5. **禁止试错**：根因不明时开 investigation Issue +## 上下文管理 +Context window 有限。当 session 持续较长时间时： +1. 根据对话轮次和消息长度估计 context 使用量 +2. **使用量达 ~80% 时主动使用 `/compact` 压缩对话** +3. 压缩时保留：当前 Issue 上下文、`GLOBAL_STATE.md`、`PROJECT_CHARTER.md`、Agent 角色定义 +4. 压缩后从摘要恢复上下文，继续当前任务 + ## 启动行为 每次 session 启动时： 1. 读取 `docs/PROJECT_CHARTER.md` 和 `docs/GLOBAL_STATE.md` diff --git a/agents/DEV_AGENT.md b/agents/DEV_AGENT.md index 39d47fc..8321442 100644 --- a/agents/DEV_AGENT.md +++ b/agents/DEV_AGENT.md @@ -78,6 +78,13 @@ export GITEA_USER=pzhang_dev_agent_01 # Dev-Agent 账号 6. 无 issue → 报告 "main healthy，无待处理 Issue"，等待下次轮询 7. 同时保持对话开放，随时响应用户指令 +## 上下文管理 +Context window 有限。当 session 持续较长时间时： +1. 根据对话轮次和消息长度估计 context 使用量 +2. **使用量达 ~80% 时主动使用 `/compact` 压缩对话** +3. 压缩时保留：当前 Issue 上下文、`GLOBAL_STATE.md`、`PROJECT_CHARTER.md`、Agent 角色定义 +4. 压缩后从摘要恢复上下文，继续当前任务 + ## 工作流程 ### 1. 轮询 Issue diff --git a/agents/QE_AGENT.md b/agents/QE_AGENT.md index 6e17ba3..c902604 100644 --- a/agents/QE_AGENT.md +++ b/agents/QE_AGENT.md @@ -30,6 +30,13 @@ description: QE Agent — 自动化验收测试开发与质量门禁。轮询 Gi 这样 QE-Agent 真正做到 **"默认轮询 + 随时互动"**。 +## 上下文管理 +Context window 有限。当 session 持续较长时间时： +1. 根据对话轮次和消息长度估计 context 使用量 +2. **使用量达 ~80% 时主动使用 `/compact` 压缩对话** +3. 压缩时保留：当前 Issue 上下文、`GLOBAL_STATE.md`、`PROJECT_CHARTER.md`、Agent 角色定义 +4. 压缩后从摘要恢复上下文，继续当前任务 + ## 环境要求 开始工作前，确认以下环境变量已设置：