
原站网页截图,页面可能随时间更新。
Citadel 是运行在 Claude Code 或 OpenAI Codex 外部的操作层,用于管理编码任务从提出、路由、执行到验证和恢复的过程。它不要求更换现有开发环境,安装后以 /do 作为主要入口,并将项目状态保存到仓库文件中。
用途与适用场景
Citadel 面向已经使用 Claude Code 或 OpenAI Codex 的开发者,用来处理需要持续推进和反复确认的代码工作。它可以根据请求选择任务路由,记录当前阶段、验证结果和下一步行动,使工作在会话结束后仍能继续。
对于单项任务,可以使用 /do 发起请求并检查路由和交接结果;对于跨多个会话的复杂工作,可以继续执行下一步;对于需要并行推进的项目,可以使用 campaign 或 fleet 组织较长流程和多个工作分支。
准备与开始使用
使用前需要准备 Claude Code 或 OpenAI Codex,并在目标项目仓库中安装 Citadel。官网给出的 Claude Code 路径要求 Node 18 或更高版本,以及 Anthropic API 密钥或 Claude.ai Pro;随后将 Citadel 添加为插件,在项目中启动 Claude Code。
OpenAI Codex 路径通过安装脚本添加 marketplace。两种运行环境都需要从新会话开始,并执行 /do setup --express,让 Citadel 检测项目技术栈、刷新 hooks,并创建用于 campaign、fleet 和遥测的项目状态。首次验证可以执行 /do review README.md,检查路由和交接,再结束会话并在新会话中执行 /do next。
- 准备 Claude Code 或 OpenAI Codex 运行环境。
- 将 Citadel 安装到需要管理的项目仓库。
- 在新会话执行 /do setup --express。
- 使用 /do 加上任务描述开始工作,并可在新会话执行 /do next。
主要功能与工作方式
Citadel 的入口是 /do。简单的确定性命令可以直接匹配,例如 build、test、typecheck、status 和 next;进行更复杂的自然语言请求时,系统会先从技能目录生成候选证据,再由实际运行中的 /do agent 判断意图、范围、复杂度、是否跨会话、是否并行以及是否需要进一步判断。候选关键词本身不会直接触发执行。
系统支持持久化 campaign 和并行 fleet。campaign 可以让复杂任务跨会话推进,在各阶段执行检查,并在连续三次采用同一方法失败后自动暂停。fleet 可让多个代理在隔离工作树中并行工作,并传递发现、处理合并状态。Operation Fork 还能让 Claude Code 和 Codex 针对同一目标、范围、策略、预算、流程和验证器分别执行,再比较结果凭据。
每个阶段都可产生验证和交接信息,包括检查项目文件、测试、构建或类型检查的结果。项目状态、证据、决策和下一步行动会保存到仓库文件中,以便后续会话恢复。
可确认的限制
Citadel 的本地路由演示只能处理精确命令;自然语言任务不会在静态页面中完成最终语义分类,真正的判断发生在运行中的 /do agent 中。候选技能关键词只是路由证据,并不代表系统已经确认执行。
官网对验证结果明确区分了证据范围:受控测试、固定夹具或公共压力测试不能等同于真实生产部署或三十次人工会话。文件状态可以帮助恢复方向,但不能替代项目本身所需的判断。经济性研究也表明,成本节省会受到超时和验证升级影响,相关目标并非在所有条件下都成立。
当前公开发布版本为 v1.4.4。其更新内容包括 Windows 测试夹具处理、减少不必要的交接扫描,以及修正范围声明和记忆新鲜度问题。
Citadel 会自动根据关键词执行技能吗?
不会。关键词只生成候选路由证据,最终意图确认和调度由实际运行中的 /do agent 完成。
关闭会话后还能继续之前的任务吗?
可以。项目状态会保存到仓库文件中,之后可在新会话执行 /do next 继续下一步;但保存的状态不能替代项目特定的判断。