給 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。事實放在最前面。
- Claimsagent 最後一則訊息說它做了什麼(測試通過、lint 通過、build 成功、已 commit、已 push、已 merge),拿去對照 transcript。每個 claim 都有判定,並附上決定判定的那個指令。英文和繁體中文的訊息都會檢查。
- Tests每次跑測試的結果,從 exit status 和完整輸出判斷。如果 pipe 或分號把 exit status 藏起來,receipt 會直接標出來,不會用猜的。
- 改過的檔案用 Edit、MultiEdit、Write 改過的檔案,加上可能改到檔案的 shell 指令(>、tee、sed -i、mv…)。
- 錯誤每個失敗的 tool call。
- 沒有結果的呼叫一直沒拿到結果的呼叫,所以沒有東西可以判斷。
- Git每個 git commit、push、merge 和 gh pr merge,以及它們的結果。agent 說「已 commit、已 push」時,要靠這裡證明。
- Sub-agent 與指令誰跑了什麼。完整的指令表收在最後的摺疊區塊裡。
Claim 的判定
- ✅ backed
- transcript 裡看得到它真的發生了。
- ❌ contradicted
- transcript 顯示的是相反的結果。
- ⚠️ cannot tell
- 有證據,但不足以判定。
- ❓ no evidence
- transcript 裡找不到支持它的東西。
問句、指示和否定句不算 claim。