渐进式摘要的风险
数字、百分比和日期在摘要后会变得含糊。
渐进式摘要的风险 是 CoddyKit 上的免费 Claude Architect 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Claude Architect 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Claude Architect 课程共包含 4 节课。
本课时的部分内容尚未翻译,以英文显示。
Why Summaries Drift
Long-running agents can't keep every turn in the context window. A common fix is progressive summarization: periodically compress earlier messages into a shorter recap so the conversation keeps fitting.
It works for narrative flow. But it has a sharp failure mode for the Context Management & Reliability domain: when prose gets compressed, numbers, percentages and dates go vague. "$1,284.50 refunded on 2026-03-14" quietly becomes "a refund was issued recently."
What Actually Gets Lost
Summarization optimizes for gist, not precision. The model keeps the storyline and drops the exact tokens that carry transactional meaning.
- Amounts: "$4,999.00" → "a large charge"
- Percentages: "a 17.5% discount" → "a discount"
- Dates: "order placed 2026-01-09" → "earlier this year"
- IDs: "order #A-88231" → "the order"
These are exactly the facts downstream tools and policy checks depend on.
/compact Carries the Same Risk
In Claude Code, /compact compresses the running context to free up room — the same mechanism, the same risk. After a compaction, a stack trace's line numbers, a failing test's exact assertion, or a config value can come back fuzzy.
The fix isn't to avoid compaction; it's to make sure the precise facts you'll need later don't live only inside the part that gets compressed.
# Claude Code session: compaction is convenient but lossy
/compact # compresses earlier turns -> numbers/dates can become vague
# Safer: persist exact facts that must survive
/memory # write durable facts into CLAUDE.md before compactingThe Core Pattern: A Case Facts Block
The exam-grade fix is simple: pull transactional facts into a separate "case facts" block kept verbatim, outside the summary.
Summarize the conversational narrative freely — but maintain a structured, append-only block of exact values that is never passed through the summarizer. The summary keeps context cheap; the case-facts block keeps the numbers exact.
Structuring Case Facts
Keep the block machine-readable and verbatim. Each entry preserves the original value exactly as stated, with enough labeling to reuse it later.
This block is re-injected into the system prompt on every turn — remember the API keeps no server-side state, so you resend it as part of the full message history each request.
case_facts = {
"customer_id": "CUS-44190",
"order_id": "A-88231",
"order_date": "2026-01-09",
"order_total": "4999.00", # exact, never rounded
"discount_pct": "17.5",
"refund_amount": "1284.50",
"refund_date": "2026-03-14",
}
system = (
"You are a support agent.\n"
"## CASE FACTS (verbatim, authoritative)\n"
f"{json.dumps(case_facts, indent=2)}\n"
"## CONVERSATION SUMMARY (may be lossy)\n"
f"{rolling_summary}"
)Summarize Narrative, Preserve Facts
Split your context-management routine in two. When you compress, run the summarizer only over the dialogue, and leave the case-facts block untouched.
Order matters too: facts go near the top, the lossy summary lower down. The model attends to the start and end of context more than the middle (lost-in-the-middle), so authoritative numbers belong where attention is strongest.
def build_context(history, case_facts, max_dialogue_turns=8):
recent = history[-max_dialogue_turns:]
older = history[:-max_dialogue_turns]
# Compress ONLY the narrative; facts are excluded from summarization
summary = summarize(older) if older else ""
return {
"facts_block": case_facts, # verbatim, top of context
"summary": summary, # lossy, fine for narrative
"recent": recent,
}Extract Facts at Capture Time
Don't try to recover exact numbers after they've been summarized away — by then the source is gone. Capture them the moment they appear, straight from tool results.
Trim verbose tool output to the relevant fields before it enters history, but route the precise values you'll need into the case-facts block first. Use structured output (a tool call with a JSON Schema) so extraction is reliable, not a regex guess.
# After lookup_order returns, capture facts verbatim before trimming
order = tool_result["order"]
case_facts.update({
"order_id": order["id"],
"order_total": order["total"], # keep raw string/decimal
"order_date": order["created_at"],
})
# Now the full verbose payload can be trimmed/summarized safelyWhy Retry Won't Save You
A tempting reflex: if a later answer cites the wrong amount, just retry with feedback. But retry-with-feedback only fixes format, structural or arithmetic errors — you resend the original doc, the wrong output, and the exact validation error.
Once a number has been summarized out of the context entirely, the information is simply absent from the source. Retry does not help when info is absent. Prevention (the facts block) is the only reliable fix.
Guard Hard Rules with Hooks, Not Memory
When a number gates a consequential action — say a refund threshold — never let a summarized, fuzzy amount drive the decision. Enforce it deterministically.
A PostToolUse or outgoing-call hook reads the verbatim case-facts value and blocks policy violations 100% of the time. Prompts are ~90% probabilistic; hooks are deterministic. Use hooks when failure has financial, legal or safety consequences.
{
"hooks": {
"PreToolUse": [{
"matcher": "process_refund",
"command": "check_refund_limit.py"
}]
}
}
# check_refund_limit.py reads case_facts.refund_amount (verbatim),
# not the lossy summary, and exits non-zero if > $500.Keep Provenance Alongside Facts
For research and extraction work, a verbatim fact is more trustworthy with its provenance: the source URL or doc name, the exact quote, and the publication date.
Dates frequently resolve apparent contradictions between conflicting stats — "revenue was $2.1M" vs "$2.4M" often just reflects different quarters. Annotate conflicting numbers with their sources rather than letting a summary silently pick one and blur the rest.
fact = {
"claim": "Q4 revenue was 2.4M USD",
"value": "2400000",
"source_doc": "FY26-Q4-earnings.pdf",
"quote": "Total revenue for Q4 reached $2.4M.",
"published": "2026-02-02",
}Fresh Session vs --resume
When a long session has been compacted many times, a resumed thread may carry a degraded summary — and resumed tool results can be stale if the codebase changed. Sometimes a fresh session seeded with a structured summary (your clean case-facts block) beats --resume.
The structured block is the carrier: it lets you start clean without losing the exact numbers and dates the work depends on.
# Long thread got fuzzy after repeated /compact?
# Start fresh and hand over the verbatim facts block:
claude -p "Resume task. ## CASE FACTS (authoritative):
$(cat case_facts.json)"
# vs. claude --resume my-session (may carry a degraded summary
# and stale tool results)Quick Check: Protecting the Numbers
A customer-support agent runs for many turns and periodically summarizes earlier messages to stay within the context window. QA finds it now quotes refund amounts and order dates that are slightly off or vague. Which fix is exam-correct?
Recap: Keep the Facts Verbatim
Key takeaways for the Context Management & Reliability domain:
- Progressive summarization (and /compact) makes numbers, percentages and dates vague — the gist survives, the precision doesn't.
- Fix: maintain a separate case-facts block, verbatim, outside the summary; summarize only the narrative.
- Capture facts at the source from tool results; never try to recover them after they're gone — retry can't restore absent info.
- Place facts near the start of context (beat lost-in-the-middle); keep provenance + dates for research.
- Gate consequential thresholds with deterministic hooks reading verbatim values, and prefer a fresh session with a structured summary over a degraded resume.
常见问题解答
「渐进式摘要的风险」课时是免费的吗?
是的 — 「渐进式摘要的风险」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Claude Architect 课程的其余内容,请升级到 CoddyKit PRO。 Claude Architect 课程共包含 4 节课。
「渐进式摘要的风险」这节课中我会学到什么?
数字、百分比和日期在摘要后会变得含糊。 你通过在浏览器中直接运行的动手代码来练习 Claude Architect,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Claude Architect 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Claude Architect 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。
「渐进式摘要的风险」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Claude Architect 课中编写并运行代码吗?
能。每节 Claude Architect 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 必须提供完整历史记录
- 渐进式摘要的风险
- 中间信息丢失效应
- 案例事实区块与裁剪输出