Q00/ouroboros — FindAgent

◯ ─────────── ◯

O U R O B O R O S

◯ ─────────── ◯

停止提示（Prompting）。开始定义（Specifying）。

这是专为可复现、以规范为先的 AI 编码工作流打造的 Agent OS。

将模糊的想法转化为经过验证的、可工作的代码库 —— 完美兼容 Claude Code、Codex CLI、OpenCode 和 Hermes。

Ouroboros 是一个用于 AI 编码的 Agent OS：它是一个本地优先的运行时层，将不确定的 Agent 工作转化为可复现、可观察且受策略约束的执行契约。它通过结构化的“以规范为先”的工作流取代了临时提示（ad-hoc prompting）：访谈、结晶、执行、评估、演进。

Ouroboros Agent OS 技术栈

与任何操作系统一样，Ouroboros 被分为稳定的 OS 层（原语）、应用层（领域工作流）以及人类直接操作的 Shell。三个仓库，一个技术栈：

层级	仓库	角色	提供功能
Shell (终端客户端)	`Q00/ourocode`	用于在单个会话中跨 Claude / Codex / Gemini CLI 运行 `ooo` 工作流的原生终端 UI	TUI、wonderTool 决策选择器、MCP 面板状态、命令发现
Apps (领域工作流)	`Q00/ouroboros-plugins`	用户级插件契约 —— 将核心原语组合成可安装的领域程序 (PR 操作、Jira 同步、事故处理、发布)	插件清单、作用域权限、审计/来源追踪、参考插件
OS (本仓库)	`Q00/ouroboros`	Agent OS 核心 —— Seed、Ledger、Runtime、MCP、安全边界	`ooo` 命令、规范优先的工作流引擎、多运行时适配器

它们如何连接：

  ourocode  ──►  ooo / ouroboros-plugins  ──►  ouroboros core (Seed · Ledger · MCP · Runtime)
   shell             user-level apps                        kernel

内核 (ouroboros) 拥有契约：每个操作都成为一个与 Seed 绑定、由 Ledger 记录、可复现的事件 —— 无论由哪个 LLM 执行。
插件 (ouroboros-plugins) 针对该契约声明作用域能力，因此领域工作流（审查 PR、分类 Linear 工单、执行发布）保持可审计且受策略约束，而不是一次性的提示。
Ourocode 是终端 Shell：它将 MCP 状态、访谈问题和 wonderTool 决策呈现为一等 TUI 元素，让你无需离开键盘或在多个 CLI 之间切换即可驱动操作系统。

你可以单独使用 ouroboros 配合任何支持的 CLI，通过叠加插件来处理领域工作流，或者在需要统一终端驾驶舱时安装 ourocode。

免责声明。 Ouroboros 项目及社区与任何加密货币、代币、迷因币或交易社区无关 —— 包括但不限于 pump.fun 或其他启动平台上的任何 "ouroboros" 代码。这是一个开源开发者工具。我们不发行、背书或持有任何代币。任何声称与本项目相关的代币均为未经授权。

为何选择 Ouroboros？

大多数 AI 编码的失败不在于输出，而在于输入。瓶颈不在于 AI 的能力，而在于人类的清晰度。

问题	现状	Ouroboros 的解决方案
模糊的提示	AI 靠猜，你需要重做	苏格拉底式访谈揭示隐藏假设
没有规范	架构在构建中漂移	不可变的 Seed 规范在编码前锁定意图
手动 QA	“看起来不错”并非验证	三阶段自动化评估门控

快速开始

安装 —— 一条命令，自动检测所有内容：

curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | bash

构建 —— 打开你的 AI 编码 Agent 并开始：

> ooo interview "I want to build a task management CLI"

适用于 Claude Code、Codex CLI、GitHub Copilot CLI、OpenCode、Hermes、Gemini 和 Kiro CLI。安装程序会自动检测 Claude Code、Codex CLI 和 Hermes CLI 并注册 MCP 服务器。对于 OpenCode、Kiro 或 GitHub Copilot CLI，请在安装后运行 ouroboros setup --runtime <runtime>。Copilot CLI 运行时通过 GitHub Copilot 模型 API 实时发现其模型目录，并允许你在设置期间选择默认值。

Kiro CLI 快速开始

pip install 'ouroboros-ai[claude]'
ouroboros setup            # 检测 Kiro CLI 并注册 MCP 服务器

在 .env 中设置运行时：

OUROBOROS_RUNTIME=kiro

然后在 Kiro CLI 会话中使用 ooo 命令。

GitHub Copilot CLI 快速开始

gh auth login                                # 一次性 GitHub 认证（用于实时模型发现）
pipx install 'ouroboros-ai[mcp]'             # 或者: uv tool install 'ouroboros-ai[mcp]'