SethGammon/Citadel

解决的问题

Citadel 为 Claude Code 和 OpenAI Codex 等 AI 编码代理提供了一个操作层。它解决了当代理主导的编码任务超出单个提示范围时，上下文丢失和工作流碎片化的问题，确保在不同会话之间保留仓库状态、决策和交接信息。

如何工作

Citadel 作为编码代理的插件集成，引入了 /do 入口点以接收自然语言请求。它通过一个包含五个状态的结构化循环来管理流程：请求、运行、证据、需要您（用于审批或冲突处理）、恢复（用于识别新会话的下一步操作）。它在专用目录（如 .planning/ 和 .citadel/）中维护项目本地状态，以追踪活动、证据和遥测数据，而不会干扰应用程序代码。

适用人群

使用 Claude Code 或 OpenAI Codex 执行复杂、多步骤编码任务，需要持久化状态、明确的验证边界以及跨多个代理或分支协调的开发者。

主要亮点

• 持久化会话状态：保留仓库本地的决策和发现，以便在不同会话间恢复工作。
• 统一入口点：使用单一的 /do 命令将自然语言请求路由到特定工作流。
• 验证证据：记录并报告结果为通过、失败、阻塞或未知，使代理评估可被检查。
• 安全边界：实施审批门禁和显式验证，以管理高风险或多步骤变更。
• 跨平台支持：兼容 Linux、macOS 和 Windows 上的 Node.js 22+。