[Feature]: Work-aware Context Advisor:解释上下文选择,并保留任务中的关键结论
Related: #795 proposes the Context Strategy Extension API. This issue describes one user-facing feature built on it.
Problem
长任务中,Runtime 会因 Context 压力压缩历史、工具说明和工具结果。开发者通常难以直接看见:哪些材料被保留、压缩或移出,为什么这样处理,原件还能否恢复,以及这些变化是否真的服务于当前 Work / Task。
同时,AGENTS.md、CLAUDE.md 等文件只能保存事先知道的规则。Agent 在执行中通过资料、工具和测试得到的根因、决定、失败结论与风险,仍可能只存在于 message 中,并在压缩后消失。
Proposal
增加一个以当前 Work / Task 为中心的只读 Context Advisor,包含两项同等重要的能力:
1. 解释和建议 Context 的命运
对工具、message、tool result、事实和证据给出:
keep / condense / defer / rehydrate
报告它与当前 Work / Task 的关系、预计 Token 变化、Prefix Cache 影响和恢复入口。用户可以选择本次忽略、允许压缩,或在当前 Task / 整个 Work 中固定保留。Explain 应区分“Advisor 的建议”和“Runtime 实际执行的动作”。
2. 保留 Agent 已经获得的工作认识
从用户可见的模型输出和工具结果中提出 Derived Work Fact 候选,例如根因、决定、假设、风险和失败方案。每条候选保留结论、证据引用和作用范围,由用户确认、编辑或拒绝。
DERIVED WORK FACT #27
根因:SDK 与业务层的双重重试造成重复扣款
证据:SDK 文档 #12 / 线上日志 #38 / 并发测试 #42
38 rounds → compacted
fact #27 → retained
evidence → recoverable
确认后的事实由 Runtime 持久管理;证据变化时可以标记为过期,或被新结论替代。Explain 还应显示它是否真正进入本轮模型请求。
First-stage boundary
- 第一阶段只提供 Advisor / Shadow 结果,不自动改写真实 Context;
- 不保存或要求暴露模型隐藏的 chain-of-thought,只保存可复查的结论与证据;
- 被移出的材料必须仍可发现和恢复,不能把“当前不用”变成永久删除;
- 未经过对照评测前,不宣称它必然省钱或提升任务质量。
该能力希望让开发者既能看见 Context 如何围绕 Work 变化,也能保护 Agent 已经取得的工作认识:上下文可以变短,工作进展不必归零。
[Feature]: Work-aware Context Advisor:解释上下文选择,并保留任务中的关键结论
Problem
长任务中,Runtime 会因 Context 压力压缩历史、工具说明和工具结果。开发者通常难以直接看见:哪些材料被保留、压缩或移出,为什么这样处理,原件还能否恢复,以及这些变化是否真的服务于当前 Work / Task。
同时,
AGENTS.md、CLAUDE.md等文件只能保存事先知道的规则。Agent 在执行中通过资料、工具和测试得到的根因、决定、失败结论与风险,仍可能只存在于 message 中,并在压缩后消失。Proposal
增加一个以当前 Work / Task 为中心的只读 Context Advisor,包含两项同等重要的能力:
1. 解释和建议 Context 的命运
对工具、message、tool result、事实和证据给出:
报告它与当前 Work / Task 的关系、预计 Token 变化、Prefix Cache 影响和恢复入口。用户可以选择本次忽略、允许压缩,或在当前 Task / 整个 Work 中固定保留。Explain 应区分“Advisor 的建议”和“Runtime 实际执行的动作”。
2. 保留 Agent 已经获得的工作认识
从用户可见的模型输出和工具结果中提出
Derived Work Fact候选,例如根因、决定、假设、风险和失败方案。每条候选保留结论、证据引用和作用范围,由用户确认、编辑或拒绝。确认后的事实由 Runtime 持久管理;证据变化时可以标记为过期,或被新结论替代。Explain 还应显示它是否真正进入本轮模型请求。
First-stage boundary
该能力希望让开发者既能看见 Context 如何围绕 Work 变化,也能保护 Agent 已经取得的工作认识:上下文可以变短,工作进展不必归零。