【免费下载链接】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），仅供参考