Covenant Framework

项目简介 Covenant Framework 是一套面向多 Agent AI 系统的治理框架，提供结构化管理、生命周期控制和质量保障。当多个 AI Agent 协同工作时，会出现大量协调问题：谁遵循什么规则、如何通信、何时停止与反思、系统如何从故障中恢复——Covenant 通过「宪法」（Constitution）和「解释器」（Interpreter）两大核心组件系统性地解决这些问题。它在 Claude Code 和 OpenAI Codex CLI 中均可直接运行，无需外部依赖。 核心功能 Interpreter 解释器：系统中唯一与用户直接对话的 Agent，负责接收用户请求、检查系统状态、提议 Agent 组合方案，并等待用户确认后启动执行 12 种 Agent 类型：Interpreter、Analyst、Writer、Synthesist、Guardian、Shepherd、Scribe、Stress Tester 等，覆盖从研究分析到代码实现的完整工作流 宪法机制（Constitution）：36 个章节的不可变规则，所有 Agent 启动前必须通过宪法检查，确保行为边界和伦理约束 16 条治理命令：包括 /spawn（生成新 Agent）、/consolidate（合并记忆）、/checkpoint（保存检查点）、/audit（审计）、/remember（记忆）等 四阶段生命周期：GENESIS（解释任务、分配边界）→ SPAWN（启动 Agent）→ EXECUTE（执行任务）→ SHUTDOWN（写退出报告、通知父节点） 记忆继承系统：退出报告、结构化备忘录、语义记忆和定期整合循环，使系统能记住历史学习成果 运行时钩子：Agent 门槛、Token 记录、关闭编排和会话检查四类钩子，支持精细化的运行时干预 技术实现 Covenant 的架构核心是「解释器模式」：用户只与一个 Interpreter 对话，由它来协调其他专门的 Agent。具体流程为：用户描述需求 → Interpreter 分析需求并规划 Agent 组合 → 用户确认「go」→ Agent 按生命周期阶段依次执行 → 各 Agent 退出时写 exit report → 系统整合所有输出并记忆关键信息。Agent 的启动需要通过三重门禁（Genesis Phase）：读取 mandate（任务指令）、确认在宪法和自身能力范围内、继承相关历史记忆。这种设计确保每个 Agent 的行为都可追踪、可审计、可回滚。 在 Terminal-Bench 2.0 基准测试中（89 个任务），Covenant 架构实现 67.4% 的无重试成功率，而对照组（随意编排的多 Agent 系统）仅 42%。 快速上手 安装 CLI：pip install covenant-cli 创建治理项目：covenant create "A research app that searches papers and writes reviews"，自动生成完整项目结构 进入开发：cd my-project && claude，直接进入交互式开发 向解释器描述需求：「帮我构建一个用户管理 REST API」 等待方案确认：Interpreter 会生成计划——启动 Analyst 研究代码库、Writer 实现 API——用户说「go」后执行 查看退出报告：任务完成后，每个 Agent 的 exit report 保留在 memory 系统中，可供后续任务参考 适用人群 AI 研究人员：需要系统化研究多 Agent 协作模式和治理机制 企业 AI 开发者：构建需要可审计、可问责 AI 系统的团队 AI 安全研究者：通过宪法机制研究 Agent 行为边界和安全约束 复杂任务自动化开发者：需要多步骤、长周期、需定期回顾的复杂任务编排