SethGammon/Citadel

解決的問題

Citadel 為 Claude Code 和 OpenAI Codex 等 AI 編碼代理提供了一個操作層。它解決了當代理主導的編碼任務超出單一提示範圍時，上下文遺失與工作流程碎片化的問題，確保在不同會話之間保留倉儲狀態、決策與交接資訊。

如何運作

Citadel 作為編碼代理的外掛程式整合，引入 /do 入口點以接收自然語言請求。它透過一個包含五個狀態的結構化循環來管理流程：請求、執行、證據、需要您（用於審核或衝突處理）、恢復（用於識別新會話的下一步動作）。它在專用目錄（如 .planning/ 和 .citadel/）中維護專案本地狀態，以追蹤活動、證據與遙測資料，而不會干擾應用程式程式碼。

適用對象

使用 Claude Code 或 OpenAI Codex 執行複雜、多步驟編碼任務，需要持久化狀態、明確的驗證邊界，以及跨多個代理或分支協調的開發者。

主要亮點

• 持久化會話狀態：保留倉儲本地的決策與發現，以便在不同會話間恢復工作。
• 統一入口點：使用單一的 /do 命令將自然語言請求路由至特定工作流程。
• 驗證證據：記錄並報告結果為通過、失敗、阻塞或未知，使代理評估可被檢視。
• 安全邊界：實施審核門檻與顯式驗證，以管理高風險或多步驟變更。
• 跨平台支援：相容於 Linux、macOS 和 Windows 上的 Node.js 22+。