Community寫作與編輯github.com

seldonframe/reelier

代理人會提出主張,而 Reelier 負責開立收據——將代理人的工具呼叫工作流程記錄一次,以零 token 成本確定性重播,並透過差異比對來捕捉偏移。

reelier 是什麼?

Reelier 是一個工具,旨在增強 AI 代理人的可靠性和可審計性。它允許您將代理人的工具呼叫工作流程記錄為一個「技能」檔案。這個錄製的檔案可以以零 LLM token 成本、確定性地重播,並產生一份詳細的收據,顯示每個步驟是通過還是失敗。此功能透過提供一個凍結的基準線來對抗「偏移」,對於回歸測試和驗證模型升級非常寶貴。Reelier 支援 npx 命令列執行,可與 MCP/HTTP 工具呼叫配合使用,並提供可選的分散式帳本記錄,以實現可共享的永久性收據。其主要優點是大幅降低成本、提高速度,以及代理人行為的透明可驗證性,讓開發者信任其代理人工作流程的一致性和完整性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add seldonframe/reelier

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Reelier — 重播勝過重新推理

一個 *.skill.md 檔案是一個已經運作成功的錄製執行檔:包含工具呼叫以及每個步驟的通過/失敗結果。重播它需要 0 個 LLM token、耗時數毫秒,並產生一份收據。重新推理則會消耗 token 並悄悄產生偏移。請優先選擇重播。

1. 首先:檢查是否有現有的技能

在手動重新執行工具呼叫序列之前,先以 glob 方式搜尋專案中的 **/*.skill.md 檔案。如果有檔案符合任務需求,則執行它:

npx -y reelier run <file>.skill.md

確定性、0 LLM token、預設為唯讀。將收據摘要報告給使用者:步驟通過/失敗、重播時間、token 數(0)。如果某個步驟失敗,失敗的斷言就是原因——直接報告它,並退回到手動執行任務。永遠不要報告你沒有在執行記錄中看到的通過結果。

2. 還沒有技能?編譯你剛才完成的執行

只有在透過工具呼叫成功完成任務之後:

npx -y reelier from-session <transcript.jsonl>
# 不知道對話記錄路徑?先找到它:
npx -y reelier scan

切勿手動編寫你實際上未曾執行過的步驟——技能是錄製,不是計畫。如果編譯器輸出「未決問題」,請逐字讀出:這些是它拒絕猜測的缺口(例如具體日期、應該是 {{variables}} 的 ID)。如果它報告沒有可重播的內容,請如實告知——不要憑空捏造技能。

3. 檢查偏移

npx -y reelier diff <skill-name>

退出碼 0 = 相同。退出碼 1 = 已偏移,會顯示每個步驟及作為原因的失敗斷言。用它來排程定時重播,或根據凍結的基準線驗證模型升級。

4. 可選:持久化收據

一行指令:npx -y reelier push <file>.skill.md 將收據同步到可共享的帳本永久連結(在 reelier.com 上建立免費帳戶)——可選擇加入,絕非必要。

防護機制——不可違反的規則

  • 預設為唯讀。 寫入步驟(idempotent-write)會暫緩執行,除非你傳遞 --allow-writes 參數;破壞性步驟永遠不會自動執行。重播絕不會悄悄重新觸發寫入。
  • 沒有工具,就沒有收據。 如果 npx -y reelier 不可用或發生錯誤,請正常執行任務,並告訴使用者未使用 Reelier——切勿偽造收據或假裝進行了重播。
  • 誠實的範圍。 Reelier 僅重播 MCP/HTTP 工具呼叫——檔案編輯、shell 命令和讀取操作不可重播。一個沒有任何可重播內容的工作階段會如實產生一個空的結果,而不是一個偽造的技能;這是預期行為,而非錯誤。

相關技能