Merge pull request 'fix: Agent session 应在 context window 达到 80% 时自动压缩对话 - Closes #115' (#119) from test/issue-115-context-compression into main

.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

.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. 压缩后从摘要恢复上下文，继续当前任务
+
 ## 环境要求
 
 开始工作前，确认以下环境变量已设置：

CLAUDE.md

@@ -16,6 +16,14 @@
 - Agent 身份通过各自环境变量设置（Dev: `pzhang_dev_agent_01`，QE: `pzhang_qe_agent_01`）
 - **所有 Gitea API 操作必须通过 `python scripts/agent_poller.py`**，禁止直接 curl 或硬编码 token
 
+## 上下文管理
+
+Context window 有限。当 session 持续较长时间时：
+1. 根据对话轮次和消息长度估计 context 使用量
+2. **使用量达 ~80% 时主动使用 `/compact` 压缩对话**
+3. 压缩时保留：当前 Issue 上下文、`GLOBAL_STATE.md`、`PROJECT_CHARTER.md`、Agent 角色定义
+4. 压缩后从摘要恢复上下文，继续当前任务
+
 ## 核心规则
 
 1. 代码改动走完整流程：Issue → 分支 → 开发/UT → pytest → PR → CI → merge → 自行验证 → 关闭 Issue

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

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. 压缩后从摘要恢复上下文，继续当前任务
+
 ## 环境要求
 
 开始工作前，确认以下环境变量已设置：