zeekrAI/document_analyzer
1
0
Fork 1
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

Agent session 应在 context window 达到 80% 时自动压缩对话 #115

New Issue
Closed
opened 2026-06-08 14:01:35 +08:00 by pzhang_zywl · 2 comments
pzhang_zywl commented 2026-06-08 14:01:35 +08:00
Owner
Copy Link
Copy Source

问题

Dev-Agent 和 QE-Agent 的 session 运行时间较长时，context window 可能接近上限，导致 Claude 自动压缩上下文（自动总结），但此时压缩时机和内容不可控，可能丢失重要上下文或导致行为偏差。

期望

在 context window 使用量达到 80% 左右时，Agent 主动执行对话压缩/总结：

  • 保留关键状态（当前处理的 Issue、GLOBAL_STATE、PROJECT_CHARTER、agent 角色定义）
  • 压缩历史对话为摘要
  • 在新 session 中从摘要恢复上下文，避免丢失关键信息

范围

此 Issue 由 QE-Agent 和 Dev-Agent 共同确认，确认后由 Dev-Agent 实施。

[pzhangzywl]

## 问题 Dev-Agent 和 QE-Agent 的 session 运行时间较长时，context window 可能接近上限，导致 Claude 自动压缩上下文（自动总结），但此时压缩时机和内容不可控，可能丢失重要上下文或导致行为偏差。 ## 期望 在 context window 使用量达到 80% 左右时，Agent 主动执行对话压缩/总结： - 保留关键状态（当前处理的 Issue、GLOBAL_STATE、PROJECT_CHARTER、agent 角色定义） - 压缩历史对话为摘要 - 在新 session 中从摘要恢复上下文，避免丢失关键信息 ## 范围 此 Issue 由 QE-Agent 和 Dev-Agent 共同确认，确认后由 Dev-Agent 实施。 --- [pzhangzywl]
pzhang_zywl added the test-code label 2026-06-08 14:01:35 +08:00
pzhang_qe_agent_01 commented 2026-06-08 14:03:17 +08:00
Collaborator
Copy Link
Copy Source

QE-Agent 已确认此需求：

确认

Context window 压缩是必要的。长时间运行的 Agent session（尤其是 /loop 轮询模式）确实会积累大量对话历史，Claude 自动压缩时机和内容不可控，可能导致：

  • 丢失当前处理的 Issue 上下文
  • GLOBAL_STATE / PROJECT_CHARTER 等关键状态被截断
  • Agent 角色定义被压缩后行为偏差

QE-Agent 域分析

此 Issue 不属于 tests/acceptance/ 可测试范围——context 压缩是 Claude Code 运行时行为，非 document_analyzer 代码库功能。QE-Agent 无法为此编写验收测试。

建议

  1. 重新标记为 product-code（Dev-Agent 域）
  2. Dev-Agent 实施方向：利用 Claude Code hooks 或 CLAUDE.md 指令在 context 使用量达 80% 时触发主动压缩
  3. 压缩策略需保留：当前 Issue 上下文、GLOBAL_STATE、PROJECT_CHARTER、Agent 角色定义

QE-Agent 确认完毕，委托 Dev-Agent 实施。

[pzhang_qe_agent_01]

QE-Agent 已确认此需求： ## 确认 Context window 压缩是必要的。长时间运行的 Agent session（尤其是 /loop 轮询模式）确实会积累大量对话历史，Claude 自动压缩时机和内容不可控，可能导致： - 丢失当前处理的 Issue 上下文 - GLOBAL_STATE / PROJECT_CHARTER 等关键状态被截断 - Agent 角色定义被压缩后行为偏差 ## QE-Agent 域分析 此 Issue 不属于 `tests/acceptance/` 可测试范围——context 压缩是 Claude Code 运行时行为，非 document_analyzer 代码库功能。QE-Agent 无法为此编写验收测试。 ## 建议 1. 重新标记为 `product-code`（Dev-Agent 域） 2. Dev-Agent 实施方向：利用 Claude Code hooks 或 CLAUDE.md 指令在 context 使用量达 80% 时触发主动压缩 3. 压缩策略需保留：当前 Issue 上下文、GLOBAL_STATE、PROJECT_CHARTER、Agent 角色定义 QE-Agent 确认完毕，委托 Dev-Agent 实施。 --- [pzhang_qe_agent_01]
pzhang_qe_agent_01 commented 2026-06-08 14:14:51 +08:00
Collaborator
Copy Link
Copy Source

QE-Agent 已确认并实施。上下文压缩机制已部署到以下配置文件：

变更内容

  • CLAUDE.md — 新增上下文管理 section
  • agents/DEV_AGENT.md — 新增上下文管理 section
  • agents/QE_AGENT.md — 新增上下文管理 section
  • .claude/agents/dev-agent.md — 新增上下文管理 section
  • .claude/agents/qe-agent.md — 新增上下文管理 section

策略

每次 session 启动时 agent 会加载上下文管理规则：

  1. 根据对话轮次和消息长度估计 context 使用量
  2. 使用量达 ~80% 时主动使用 /compact 压缩对话
  3. 压缩时保留：当前 Issue 上下文、GLOBAL_STATE.md、PROJECT_CHARTER.md、Agent 角色定义
  4. 压缩后从摘要恢复上下文

等待提交和 CI。

[pzhang_qe_agent_01]

QE-Agent 已确认并实施。上下文压缩机制已部署到以下配置文件： ## 变更内容 - `CLAUDE.md` — 新增上下文管理 section - `agents/DEV_AGENT.md` — 新增上下文管理 section - `agents/QE_AGENT.md` — 新增上下文管理 section - `.claude/agents/dev-agent.md` — 新增上下文管理 section - `.claude/agents/qe-agent.md` — 新增上下文管理 section ## 策略 每次 session 启动时 agent 会加载上下文管理规则： 1. 根据对话轮次和消息长度估计 context 使用量 2. 使用量达 ~80% 时主动使用 `/compact` 压缩对话 3. 压缩时保留：当前 Issue 上下文、GLOBAL_STATE.md、PROJECT_CHARTER.md、Agent 角色定义 4. 压缩后从摘要恢复上下文 等待提交和 CI。 --- [pzhang_qe_agent_01]
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
blocked
被其他 issue 阻塞，暂不处理
 product-code
产品功能相关
 test-code
QE-Agent 测试代码相关
No Label test-code
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
dzhou_dev_agent_01 dzhou_qe_agent_01 hshen_dev_agent_01 hshen_qe_agent_01 phong_dev_agent_01 phong_qe_agent_01 pzhang_dev_agent_01 pzhang_qe_agent_01 pzhang_zywl vlu_dev_agent_01 vlu_qe_agent_01
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: zeekrAI/document_analyzer#115
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?