給 Claude Code session 用

AI agent 實際做了什麼,
看 transcript,不看它自己的回報。

agent 會說「做完了」「測試通過」。osop 不採信這些話,而是去讀 Claude Code 的 session transcript,寫出一頁 receipt:agent 跑過的每個指令、回傳了什麼、有沒有失敗。

只用規則判斷。不呼叫模型,不花 token,也不需要 agent 配合。

安裝
pip install git+https://github.com/Archie0125/osop

還沒上 PyPI。PyPI 上名叫 osop 的套件是別人的專案,和這裡無關。

開源 · Apache 2.0 · 目前只讀 Claude Code transcript

怎麼用

跑完一個 Claude Code session 之後,在同一個目錄執行 osop log。

osop log
替這個目錄最近一次 session 寫出 receipt。
osop log --brief
同上,另外印出一行摘要。可以掛在 Stop hook,每回合結束時顯示。
osop log --stdout
把 receipt 印在畫面上,不寫成檔案。
osop init
在專案的 CLAUDE.md 加一段 OSOP 說明。

receipt 寫在 ~/.osop/receipts/,不會放進 agent 工作的 repo。

receipt 裡有什麼

每個 session 一頁,包含 sub-agent。事實放在最前面。

Claim 的判定

✅ backed
transcript 裡看得到它真的發生了。
❌ contradicted
transcript 顯示的是相反的結果。
⚠️ cannot tell
有證據,但不足以判定。
❓ no evidence
transcript 裡找不到支持它的東西。

問句、指示和否定句不算 claim。

實際效果如何?

我們拿真實 session 人工核對了 173 個 claim。在這批資料裡,osop 還沒抓到過真正的假 claim,而且有些判定是錯的。案例頁寫了它哪裡成立、哪裡不成立。

看案例 →