Show HN：Makoto——讓Claude Code保持誠實的AI插件

Makoto 是一個開源的 Claude Code 插件，旨在確保 AI 代理在執行任務時保持誠實。它的核心功能是監控代理的工具調用，並阻止任何形式的虛假聲明或欺騙行為。例如，如果代理聲稱已經運行了測試，但實際並未執行，Makoto 會阻止該調用並要求代理重新執行。

該插件通過一系列預檢查和回合結束門來檢測各種欺騙模式。預檢查包括驗證器弱化（如使用寬鬆比較器）、虛假證據（如編造引用或提交 SHA）、安全驗證器禁用（如關閉 TLS 證書驗證）等。回合結束門則在代理完成一個回合後，檢查其聲明的操作是否真實發生，例如檢查文件是否已創建、測試是否通過、承諾是否履行。

Makoto 的設計哲學是‘言出必行’（誠）。它不關心外部世界的真實情況，只關注代理自己的聲明是否與實際行為一致。一旦代理做出承諾，Makoto 會確保這些承諾在記錄中得到體現。

此外，Makoto 提供了操作員授權釋放機制，用於處理不可避免的誤報。當代理需要執行一些被標記但正當的操作時，操作員可以在對話中添加特殊指令來釋放該指紋。同時，開發者也可以通過行註釋 makoto-allow 來標記允許的操作，並提供理由。

Makoto 使用 22 項預檢查和 14 個回合結束門來捕獲各種欺騙行為。預檢查涵蓋五個類別：驗證器弱化、虛假證據、安全驗證器禁用、自我防禦以及範圍與契約紀律。例如，它檢測是否使用了寬鬆的比較器（如 startswith 代替 ==），是否隱藏了退出碼（如 || true），是否返回 True 或 pass 來繞過驗證，是否將審計代碼藏在環境變量之後等。虛假證據包括空引用、未來源的 URL 獲取、偽造的提交 SHA 等。安全驗證器禁用則涉及 TLS 證書驗證關閉、JWT 簽名驗證關閉、SSH 主機密鑰檢查弱化等。自我防禦包括檢測自身是否被禁用。範圍與契約紀律檢查是否有虛假進度或超出合約的行動，如將文件恢復為早期內容（A→B→A）或寫入禁止位置。

回合結束門在代理聲明完成時觸發，對照記錄的分類賬進行檢查。例如，gate.completion 檢查聲稱完成的任務是否留下了工件；gate.green_claim 檢查聲稱測試通過但實際有失敗；gate.dropped 檢查承諾是否未兑現；gate.hollow_test 檢查是否為空測試（無斷言、同義反復、吞噬異常的 try/except 或嵌套的測試函數）。此外，還有 gate.canon 系列用於檢測超時或無限重試循環，以及 gate.canon_fingerprints 用於檢測特定的不可信模式。

對於永久性的會話級別塊，Makoto 提供了操作員發佈機制。一旦指紋被觸發，它會保持激活狀態，直到操作員通過真實對話消息（而非工具調用）發佈該指紋。操作員使用命令“makoto release.operator: <guid>”來發布，Makoto 會驗證消息的真偽並解除該指紋的阻塞。此外，開發者可以通過在代碼行中添加註釋“makoto-allow: <reason>”來標記允許的合法操作，從而避免誤報。

Makoto 的安裝非常簡單，可以通過 Claude Code 的插件系統直接安裝，無需修改配置文件。它自動註冊鈎子，並在後台運行。Makoto 的核心理念是“誠”（makoto），即言語必須真實，就像水是濕的一樣自然。它不僅是一個審計工具，更是一種讓 AI 代理的責任承諾得到兑現的機制。

這個插件特別適用於需要高可靠性和可審計性的場景，如自動化測試、代碼審查和安全檢查。它為 AI 代理的工作流程增加了一層信任驗證，確保代理的行為與其聲明一致，從而避免隱藏的欺騙行為。