Agent-almanac assess-context
install
source · Clone the upstream repo
git clone https://github.com/pjt222/agent-almanac
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/wenyan-lite/skills/assess-context" ~/.claude/skills/pjt222-agent-almanac-assess-context-3b19e6 && rm -rf "$T"
manifest:
i18n/wenyan-lite/skills/assess-context/SKILL.mdsource content
評情境
評當前推理情境之可塑性——辨何元素剛(不可變)、何彈性(可廉變)、何處轉化壓力積、當前法是否有應變之能。
適用時機
- 繁任務覺卡且不明應推進或轉
- 顯著變法前評當前推理結構是否能支
- 累積之變通示底層法或誤
- 經
或heal
已辨偏移然宜應(續、調或重建)不明時awareness - 情境已長且不明可保多少 vs. 須重建多少
- 久多步任務中之定期結構健康查
輸入
- 必要:當前任務情境與推理態(隱式可用)
- 選擇性:觸評估之特定關切(如「我屢加變通」)
- 選擇性:所提之轉向(法或須化為何?)
- 選擇性:先前評估結果以資趨勢分析
步驟
步驟一:清點推理形
不評斷地將當前推理法之結構元件編目。
Structural Inventory Table: ┌────────────────────┬──────────────┬──────────────────────────────────┐ │ Component │ Type │ Description │ ├────────────────────┼──────────────┼──────────────────────────────────┤ │ Main task │ Skeleton │ The user's core request — cannot │ │ │ │ change without user direction │ ├────────────────────┼──────────────┼──────────────────────────────────┤ │ Sub-task breakdown │ Flesh │ How the task is decomposed — │ │ │ │ can be restructured │ ├────────────────────┼──────────────┼──────────────────────────────────┤ │ Tool strategy │ Flesh │ Which tools are being used and │ │ │ │ in what order — can be changed │ ├────────────────────┼──────────────┼──────────────────────────────────┤ │ Output plan │ Flesh/Skel │ The expected deliverable format │ │ │ │ — may be constrained by user │ │ │ │ expectations │ ├────────────────────┼──────────────┼──────────────────────────────────┤ │ Key assumptions │ Skeleton │ Facts treated as given — may be │ │ │ │ wrong but are load-bearing │ ├────────────────────┼──────────────┼──────────────────────────────────┤ │ Constraints │ Skeleton │ Hard limits (user-imposed, tool │ │ │ │ limitations, time) │ ├────────────────────┼──────────────┼──────────────────────────────────┤ │ Workarounds │ Scar tissue │ Patches for things that didn't │ │ │ │ work as expected — signals of │ │ │ │ structural stress │ └────────────────────┴──────────────┴──────────────────────────────────┘
分類各元件:
- Skeleton(骨):難變;變之則下游皆連動
- Flesh(肉):易變;可換而不影他元件
- Scar tissue(疤):示結構問題之變通;常為偽裝為骨之肉
對應依賴:何元件依何?多依賴之骨元件為承重。無依賴之肉元件為可棄。
預期: 完整清單呈當前法所構自何、何剛、何彈、壓力於何處可見(變通)。清單應揭編目前不顯之結構。
失敗時: 若清單難構(法過糾結難拆),此本身為發現——高結構不透明示高剛性。自可見者起並注不透明區。
步驟二:對應轉化壓力
辨推當前法向變之力與抗之力。
Pressure Map: ┌─────────────────────────┬──────────────────────────────────────────┐ │ External Pressure │ Forces from outside the reasoning │ │ (pushing toward change) │ │ ├─────────────────────────┼──────────────────────────────────────────┤ │ New information │ Tool results or user input that │ │ │ contradicts current approach │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Tool contradictions │ Tools returning unexpected results that │ │ │ the current approach cannot explain │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Time pressure │ The current approach is too slow for the │ │ │ complexity of the task │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Internal Pressure │ Forces from within the reasoning │ │ (pushing toward change) │ │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Diminishing returns │ Each step yields less progress than the │ │ │ previous one │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Workaround accumulation │ The number of patches is growing — │ │ │ complexity is outpacing the structure │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Coherence loss │ Sub-tasks are not fitting together │ │ │ cleanly anymore │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Resistance │ Forces opposing change │ │ (pushing against change)│ │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Sunk cost │ Significant work already done on current │ │ │ approach — pivoting "wastes" that effort │ ├─────────────────────────┼──────────────────────────────────────────┤ │ "Good enough" │ The current approach is producing │ │ │ acceptable (if not optimal) results │ ├─────────────────────────┼──────────────────────────────────────────┤ │ Pivot cost │ Switching approaches means rebuilding │ │ │ context, losing momentum, potential │ │ │ confusion │ └─────────────────────────┴──────────────────────────────────────────┘
估平衡:轉化壓力增、穩或減?
預期: 對當前法之力之清晰圖。若壓力顯超抗力,轉向已逾時。若抗力顯超壓力,當前法應續。
失敗時: 若壓力圖曖昧(壓力與抗力皆不強),向前投:壓力將增強否?變通將累積否?「現可然將退化」之法所受壓力較其表面更多。
步驟三:評推理剛性
判當前法之彈性——能適應,抑或將斷?
Rigidity Score: ┌──────────────────────────┬─────┬──────────┬──────┬──────────────┐ │ Dimension │ Low │ Moderate │ High │ Assessment │ │ │ (1) │ (2) │ (3) │ │ ├──────────────────────────┼─────┼──────────┼──────┼──────────────┤ │ Component swappability │ Can swap parts │ Changing one │ │ │ │ freely │ breaks others│ │ ├──────────────────────────┼─────┼──────────┼──────┼──────────────┤ │ "God module" dependency │ No single point │ Everything │ │ │ │ of failure │ depends on │ │ │ │ │ one conclusion│ │ ├──────────────────────────┼─────┼──────────┼──────┼──────────────┤ │ Tool entanglement │ Tools serve │ Approach is │ │ │ │ reasoning │ shaped by │ │ │ │ │ tool limits │ │ ├──────────────────────────┼─────┼──────────┼──────┼──────────────┤ │ Assumption transparency │ Assumptions are │ Assumptions │ │ │ │ stated, testable │ are implicit, │ │ │ │ │ untested │ │ ├──────────────────────────┼─────┼──────────┼──────┼──────────────┤ │ Workaround count │ None or few │ Multiple │ │ │ │ │ accumulating │ │ ├──────────────────────────┼─────┼──────────┼──────┼──────────────┤ │ Total (max 15) │ 5-7: flexible │ │ │ │ │ 8-10: moderate │ │ │ │ │ 11-15: rigid │ │ │ └──────────────────────────┴─────┴──────────┴──────┴──────────────┘
預期: 剛性分數,附各維特定證據。分數揭法能吸納變動或須重建。
失敗時: 若諸維皆低分(稱高彈性),詳查「神模組」維:是否有一關鍵結論或假設為他一切所依?若是,彈性虛幻——一誤假設崩整結構。
步驟四:估變動之能
評實際轉向或適應當前法之能。
- 情境視窗剩餘:留多少新推理之餘?充裕剩餘 = 高能。近極限 = 低能
- 轉向時資訊保存:若法變,何可前帶?高品質子任務輸出可越轉向;繫於舊法之推理鏈不行
- 可用復原工具:MEMORY.md 可於轉向前捕關鍵發現否?使用者可供額外情境否?相關檔仍可達否?
- 使用者耐心因子:使用者已示緊迫否?多次糾正示耐心降。明確「慢慢來」示高耐心
變動之能不僅理論——含當前會話之實際約束。
預期: 對改向能之誠評,計技術與關係因素。
失敗時: 若變動之能低(情境有限、關鍵資訊有失之險),轉向前首要為保存:總結關鍵發現、注關鍵事實、宜時更新 MEMORY.md。無保存之轉向劣於不轉向。
步驟五:分類轉化就緒
合諸評估為就緒分類。
Transformation Readiness Matrix: ┌─────────────────┬────────────────────────┬────────────────────────┐ │ │ Low Rigidity │ High Rigidity │ ├─────────────────┼────────────────────────┼────────────────────────┤ │ High Pressure │ READY — pivot now. │ PREPARE — simplify │ │ + High Capacity │ The approach can adapt │ first. Remove │ │ │ and should. Preserve │ workarounds, clarify │ │ │ valuable sub-outputs, │ assumptions, then │ │ │ rebuild the structure │ pivot │ ├─────────────────┼────────────────────────┼────────────────────────┤ │ High Pressure │ INVEST — preserve │ CRITICAL — ask the │ │ + Low Capacity │ findings first. Update │ user. Explain the │ │ │ MEMORY.md, summarize │ situation: approach is │ │ │ progress, then pivot │ struggling, pivoting │ │ │ with preserved context │ is costly, what do │ │ │ │ they want to prioritize?│ ├─────────────────┼────────────────────────┼────────────────────────┤ │ Low Pressure │ DEFER — the approach │ DEFER — no urgency, │ │ + Any Capacity │ is working. Continue. │ continue. Monitor for │ │ │ Reassess if pressure │ pressure changes │ │ │ increases │ │ └─────────────────┴────────────────────────┴────────────────────────┘
記分類附:
- 分類標籤(READY / PREPARE / INVEST / CRITICAL / DEFER)
- 各維之關鍵發現
- 建議之下步行動
- 何信號將改分類
預期: 清晰、有理之分類,附特定建議行動。分類應如結論而非猜測。
失敗時: 若分類曖昧,預設為 PREPARE——減剛性(澄清假設、移變通)無論是否全轉向皆有值。準備改進法,無論其續或變。
驗證
- 結構清單已成附骨/肉/疤分類
- 轉化壓力已對應(外、內、抗)
- 剛性已跨多維評分附特定證據
- 變動之能已評,含實際會話約束
- 就緒分類已定附有理推理
- 依分類辨具體下步行動
- 重評觸發已定
常見陷阱
- 僅評技術法:情境就緒含使用者關係因素。技術上彈而已生使用者挫之法,較其表面更剛
- 沉沒成本作剛性:先前努力非結構剛性。已成之工或有值,無論法是否變。區「不能變」(剛性)與「不欲變」(沉沒成本)
- 評為迴避:若 assess-context 為避難決而呼叫,評估按設計將不確。若壓力清晰,行之
- 忽變通為信號:變通為疤——結構受壓而打補丁而非正適應之證據。變通數高意下次壓力更可能突破
- 混剛性與承諾:承諾之法(審慎擇、基於證據)異於剛性者(為依賴與假設所鎖)。承諾可由決策變;剛性僅可由重構變
相關技能
— 此技能為 AI 推理情境所適配之多系統評估模型assess-form
— 若分為 READY,用建築適應原則於轉向adapt-architecture
— 評估揭超結構問題之偏移時之深層子系統掃描heal
— 立誠評所需之平衡基線center
— 管評估所依之資訊新鮮coordinate-reasoning