Citadel操作循环全解:从请求到证据,一图看懂/do的五状态工作流

发布时间:2026/10/23 21:11:50

Citadel操作循环全解:从请求到证据,一图看懂/do的五状态工作流 【免费下载链接】CitadelThe operating layer for Claude Code OpenAI Codex: persistent project memory, intent routing, safety hooks, cost telemetry, and parallel agent fleets.项目地址https://gitcode.com/gh_mirrors/citadel13/Citadel点击查看免费下载Citadel 是 Claude Code OpenAI Codex 的开源操作系统层它通过/do统一入口把一次任务拆成请求Request→ 执行Run→ 证据Evidence→ 需要你Needs You→ 恢复Resume五个公开状态。本文用一篇入门指南带你完整看懂 Citadel 操作循环为什么普通 Agent 会半途失忆、五状态各自在做什么、以及每一步留下的可检查证据。为什么需要操作循环普通编码 Agent 的问题不在于不会干活而在于干完活后没有留下可验证的痕迹换个会话之前做了什么、做到哪一步全部要靠重新解释做完了只是一个口头声明没有命令输出或产物可以对照遇到冲突、越权、缺失信息时Agent 可能擅自继续而不是停下来等你决策。Citadel 的回答是把每次工作都收敛成一个有界的操作循环——声明触发条件、预算、验证器、停止条件状态落在仓库本地.planning/让下一次会话可以从证据继续而不是从聊天记录猜起。官方把证明定义为不是 Agent 能描述功能而是后来的会话能检查发生了什么、并从证据继续见 docs/OPERATING_LOOP_PROOF.md。/do 五状态全解析一张表看懂核心工作流Citadel 的操作循环只有五个公开状态全部围绕/do展开定义见 README.md状态中文含义在做什么Request请求你用/do或已知技能描述期望结果Run执行被选中的工作流在运行时、仓库与审批边界内行动Evidence证据检查与产物汇报passed/failed/blocked/unknownNeeds You需要你Citadel 停下精确指出缺哪个审批、冲突或证据Resume恢复仓库本地状态为新会话指出下一步有用动作 状态一Request —— 一句话进入无需背命令你不需要记住/review、/scaffold、/triage等几十个技能名直接描述结果即可/do review README.md /do generate tests for the changed files /do next/do内部是一个统一意图路由器先做精确命令匹配再看激活状态有没有进行中的 campaign / fleet再做技能关键词候选匹配最后用 LLM 做复杂度分类范围、复杂度、是否需要持久化、是否可并行。分类完成后会宣布路由决策例如Routing to /review because …保证过程透明。如果你已经知道目标还可以显式指定路由但它依然要经过激活与安全边界检查/do --route /test-gen -- generate tests for the changed files路由细节完整定义在 skills/do/SKILL.md包括 Tier 0 精确匹配表、Tier 3 六维分类模型SCOPE / COMPLEXITY / INTENT 等和降级保护比如输入太短就不会被升级成大规模 campaign。⚙️ 状态二Run —— 在有界的边界内执行进入 Run 后工作流在运行时权限、仓库范围、审批边界内行动。Citadel 的克制原则是比例性检查单个文件的修改不会被派给并行 agent 编队多会话级任务不会被丢给一次性技能高风险命令仍走原有工具审批不会被自动放行。如果任务是重复直到通过型比如 lint 修到绿会路由到 skills/loop/SKILL.md 的有界循环必须显式提供验证器和最大尝试次数绝不静默超出声明的尝试上限。循环契约字段触发器、预算、验证器、重试、停止条件、状态路径统一规范在 docs/LOOP_CONTRACT.md 中。 状态三Evidence —— 证据只有四种结论这是 Citadel 最核心的设计证据结论只有passed、failed、blocked、unknown四种缺失的证据不会被晋升为成功。验证命令来自项目本身比如npm run test而不是凭空猜测报告必须写清文件、命令与结果别的会话可以逐条对照运行不了、查不到的能力如实报unavailable而不是假装支持。官方对好的证据的定义很朴素无聊且可检查——真实仓库、原样展示命令、报告指出文件与结论。反过来截图配声明是弱证据。信任边界提醒独立验证器才是结果证据。自报完成的 adapter 在声明了命令验证器时不足以判 pass见 docs/OPERATION_CONTROL.md 的 Trust boundary 一节。⚠️ 状态四Needs You —— 停下并说清缺什么遇到审批、冲突或证据缺失时Citadel 不做猜一个继续而是精确停止告诉你下一步缺哪个具体输入是某个审批、某个冲突解决还是某份缺失证据。这一状态配合/do next操作控制台使用体验最好——它会先展示当前状态、下一步动作、风险边界和验证方案让你在批准之前先看到 Citadel 的想法。 状态五Resume —— 新会话从状态而非聊天继续会话结束后.planning/下的仓库本地状态会记录当前在哪个工作流、停在哪、下一条最有用的命令是什么。新会话里只需/do next它会基于仓库状态恢复下一个动作campaign 继续、fleet 续跑或明确回答No active campaign or fleet session found. Nothing to continue.。这就是五状态闭环的最后一环没有状态迁移就没有真正的跨会话持久性。新手上手三步跑通第一个操作循环克隆仓库只读参考亦可git clone https://gitcode.com/gh_mirrors/citadel13/Citadel初始化安装后在目标项目里执行/do setup --expressCitadel 会在当前仓库落.planning/状态目录跑循环按 docs/OPERATING_LOOP_PROOF.md 的最小公开演示序列走一遍/do setup --express /do next /do review README.md for first-time developer friction /do identify the projects safest verification command and run it /cost最后打开.planning/operating-proof/latest.md检查产物——你能看到每一步的命令与结论这就是从请求到证据的完整闭环。延伸阅读关键文档与模块路径资料路径五状态定义README 对应段落README.md操作循环证明清单docs/OPERATING_LOOP_PROOF.md循环契约预算/验证器/停止条件docs/LOOP_CONTRACT.md/do 路由协议全文skills/do/SKILL.md/loop 有界前台循环skills/loop/SKILL.mdOperation Control 运行层docs/OPERATION_CONTROL.md总结一句话记住 Citadel 操作循环请求进、证据出中间每一步都有名字、有边界、有状态文件。Request 让你用自然语言进入不用背命令Run 保证执行不越界、不失控Evidence 只给四种诚实结论缺证据不算成功Needs You 把决策权还给人且说清楚缺什么Resume 让下一个会话从状态继续而不是从头解释。这套五状态工作流就是 Citadel 作为操作层的全部承诺——把 AI 编码 Agent 从聊天工具变成可检查、可恢复、可审计的工程系统。赞分享【免费下载链接】CitadelThe operating layer for Claude Code OpenAI Codex: persistent project memory, intent routing, safety hooks, cost telemetry, and parallel agent fleets.项目地址https://gitcode.com/gh_mirrors/citadel13/Citadel点击查看免费下载相关推荐whisper.cpp Vulkan 加速机制走读whisper.cpp Vulkan 加速机制走读 凌晨三点监控面板上那条转录延迟曲线又爬起来了8 路 16kHz 音频同时灌进 whisper.cppC人工智能语音音频本地部署Tinyhttpd工作流程图解一个HTTP请求从accept到响应的完整旅程Tinyhttpd工作流程图解一个HTTP请求从accept到响应的完整旅程 Tinyhttpd 是由 J. David Blackstone 于 1999后端网络从申请到审批Attendify请假工作流全解析request_status状态机设计揭秘从申请到审批Attendify请假工作流全解析request_status状态机设计揭秘 Attendify 是一个基于 PHP MySQL 的考勤与请创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/23 21:11:50

起床战争服务端保姆级搭建:核心选择、地图绑定与玩法配置

简介:面向《我的世界》服务器管理者和模组爱好者,这份仿 Hypixel 起床战争的服务端整合包提供了完整的开服方案。包内共 663 个文件、压缩后约 393.29MB,其中 197 个 jar 插件负责玩法逻辑,221 个 yml 文件用于配置游戏规则、权限…

2026/10/23 22:06:56

不用写繁琐前端!用 Dify / Coze 配合微信 API 极简构建微信 AI 助手

想快速让微信上有个能聊的 AI 助手,自己搭一套对话管理、prompt 配置、知识库太折腾。Dify 和 Coze 这类平台把这些都做好了,你只需要做两件事:把微信消息转成它们认识的格式、把它们的回复发回微信。一、桥接模式:微信 API 是接入…

2026/10/23 22:06:56

DeepSeek + 微信 API 实战:从零搭建 24 小时运维机器人

"运维机器人"听起来是个新东西——其实就是把 DeepSeek 的对话能力和微信的消息接口接起来,让运维人员不用半夜爬起来看服务器。但不是直接接个 API 就完了,要解决三个问题:哪些运维命令能让机器人执行、哪些不能;机器人…

2026/10/23 22:06:56

企业微信 Webhook 接入 OpenAI / Claude API,打造群内 AI 助手

群里接 AI 助手,和单聊最大的区别是:群里人多嘴杂,AI 不能见话就接,得知道什么时候该开口,什么时候该闭嘴。 先定规矩:AI 在群里什么时候说话 被 的时候:群里有人 机器人,这是明…

2026/10/22 11:29:28

金融AI落地指南:从调研报告到技术选型与工程实践

简介:这份PDF报告聚焦2025年金融服务业中国AI现状与趋势,面向金融科技从业者、AI战略规划人员及关注行业数字化转型的研究者,帮助读者把握生成式AI在银行、支付、交易等场景中的落地路径与投资方向。资源包内含1个PDF文件,大小约1…

2026/10/23 0:02:26

Verilog实现FPGA密码锁:矩阵键盘与状态机设计实战

说实话,这几年接触了不少想入门FPGA的朋友,如果你问哪个项目能一口气把Verilog的核心基本功串起来,我通常会推荐电子密码锁。这个项目看着不起眼,却把矩阵键盘扫描、按键消抖、状态机设计、动态显示刷新、外设控制这些数字逻辑里的…

2026/10/23 0:02:26

数据服务监控运维实战:从指标体系到告警治理与故障排查

周末凌晨两点,手机震了。第一反应是“数据服务挂了”。打开电脑看了下,果然,某张核心报表的数据产出时间已经超过SLA两小时,下游三个业务方连着发来问询。这种场景,做过大数据运维的人都不会陌生。数据服务的监控与运维…

2026/10/23 0:02:26

FreeRTOS任务通知实战详解:内核原理、API与避坑指南

裸机编程切到RTOS之后,任务之间的通信和同步永远是躲不开的坎。前面聊过队列、信号量、互斥锁、事件组,这次把FreeRTOS任务通知(Task Notification)单独拎出来讲透。原因很简单:任务通知是FreeRTOS里最容易用错、也最容…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑