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