Sisyphus 自主循環代理與 HUD 面板 · Oh My ClaudeCode

什麼是 Oh My Claude Code (OMC)？

Oh My Claude Code (OMC) 是一個專門為 Anthropic claude 命令列工具（Claude Code CLI）開發的工作流終端機增強套件。

在官方的 Claude Code 中，AI 主要採用的是「問答 -> 授權執行 -> 再問答」的半手動模式。這對於簡單的指令修改很方便，但如果面對需要多步驟、需要持續編譯、執行單元測試並自我修正的複雜重構，頻繁的確認和人工干預會顯得非常累贅。

OMC 通過引進自主代理循環 (Autopilot Loops) 與HUD 面板，將 Claude Code 升級為一個具備自主排程、任務狀態即時監控的高階開發站。

核心機制一：Sisyphus 自主循環代理

Sisyphus 是 OMC 中的核心「自主修復代理（Autopilot Agent）」。它的命名源自希臘神話中不斷推巨石上山的薛西弗斯（Sisyphus），象徵著它會不折不撓地反覆嘗試編譯與修復，直到測試完全通過為止。

 ┌──────────────────┐
 │  Modify Code     │◀──────────────────┐
 └────────┬─────────┘                   │
          │                             │ 失敗 (自適應修復)
          ▼                             │
 ┌──────────────────┐  編譯/測試  ┌─────┴────────────┐
 │  Build & Test    ├────────────▶│  Sisyphus Agent  │
 └──────────────────┘             └─────┬────────────┘
                                        │
                                        │ 成功 (終止循環)
                                        ▼
                               ┌─────────────────┐
                               │  Task Complete  │
                               └─────────────────┘

Sisyphus 的工作原理：

任務啟動：你給予一個複雜的除錯任務，並附加 omc --loop。
自動建置：AI 修改程式碼後，OMC 會自動觸發專案建置與單元測試。
錯誤自適應分析：如果測試失敗，OMC 不會退回終端機等待你輸入，而是直接將編譯錯誤（Compiler Errors）或測試斷言錯誤（Assertion Failures）作為新的脈絡餵回給 AI。
迭代修正：AI 依據錯誤訊息進行第二次修改、再次編譯，如此循環，直到測試覆蓋率達標且無任何錯誤為止。

核心機制二：即時 HUD 面板與狀態 HUD

當 AI 在背景自主跑 Sisyphus 循環時，終端機通常會被大量的工具日誌與中間輸出刷屏。為了讓開發者對當前 AI 的進度一目了然，OMC 提供了一個 HUD (Head-Up Display) 面板：

HUD 即時狀態欄：在終端機底部固定顯示一行狀態，如 [OMC HUD] Mode: Autopilot | Loop: 3/10 | Status: Refactoring PlcConnection.cs。
Token 監控器：即時統計當前會話消耗的 Input/Output Token、累計的 API 費用，並在快要接近設定的預算上限時自動暫停，防止「Token 暴走」造成意外帳單。
任務檢核表即時渲染：與 OpenSpec 的 tasks.md 深度整合，直接在 HUD 視窗中渲染出當前任務的勾選進度，讓你有如在看自動化工業產線般清晰。

在下一章 [OMC Team Mode 跨工作區重構] 中，我們將展示如何透過 OMC 啟動多個並行 Sisyphus 代理，進行大規模代碼庫的跨工作區重構。