context-management

上下文管理是一項專門設計的技能，旨在優化長期運行的代理編碼會話的效能與連續性。透過提供即時監控令牌消耗的工具，它使代理能夠主動管理大語言模型 (LLM) 有限的上下文視窗。這可以防止常見的資訊遺失或系統自動壓縮，從而避免中斷複雜的軟體工程工作流程。該技能的核心在於三個主要機制：狀態監控、智慧快照與多級恢復。

• 監控令牌使用百分比並提供可執行的警報（正常、考慮、建議、緊急），以預先防止上下文被截斷。

• 支援建立命名上下文快照，將對話元數據、關鍵決策與當前狀態打包成持久化檔案，儲存於 ~/.amplihack/.claude/runtime/context-snapshots/。

• 支援三種粒度的恢復級別：Essential（需求與當前狀態）、Standard（關鍵決策與待辦項目）以及 Comprehensive（完整元數據、工具歷史記錄與詳細邏輯）。

• 透過允許使用者在需要時精確恢復狀態（例如在自動壓縮後或在複雜任務間切換時），與代理工作流程無縫整合。

• 即便在主動對話視窗被迫縮減時，也能透過保留高階需求與架構決策來維護專案一致性。

• 當接近令牌限制時使用此工具，可在關鍵資料被底層模型清理前保護進度。

• 非常適合長時間的編碼任務、團隊交接，或是在多個實作分支間切換且需要狀態持久化的場景。

• 恢復過程效率極高，允許使用者根據需求從最小化上下文升級至完整文檔，確保模型始終擁有正確的資訊量來執行下一個任務，而不會浪費令牌空間。

• 與更廣泛的 amplihack 生態系統相容，與現有的 /transcripts 與 PreCompact 鉤子相輔相成，確保不會永久丟失任何關鍵的工程上下文。