ouroboros
SHA-256一个让 AI 编码不再靠猜的智能体操作系统：先访谈澄清需求，再写规范，最后自动生成并验证代码。
让 AI 编码从“猜需求”变成“按规范做”，减少返工。
核心功能
- 苏格拉底访谈：自动发问暴露隐藏假设，将模糊想法转化为清晰规范
- 不可变规范（Seed Spec）：锁定需求，防止架构漂移
- 3 阶段自动评估：机械验证 → 语义检查 → 多模型共识，告别手动 QA
- 支持主流 AI 编码工具（Claude Code、Codex CLI、OpenCode 等），安装即用
- 本地优先，数据不出本机，可复现可回放
避坑指南
- •需要 Python 3.12+；首次使用需要理解其工作流程，不能直接当普通 AI 助手用；部分运行时（如 GitHub Copilot CLI）需要额外配置；项目仍在早期，建议先小项目试用。
适用场景
- 构建命令行工具、API、自动化脚本等需要明确需求的项目
- 团队协作时统一 AI 编码的目标和规范
- 需要高质量、可验证代码的研究或商业项目
详细介绍
Ouroboros 是一个本地优先的 AI 编码智能体操作系统。它不让你直接写提示词，而是先用苏格拉底式访谈帮你理清思路、暴露隐藏假设，然后生成一份不可变的规范文档，再通过双钻石分解执行，最后经过机械、语义和多模型共识三级评估。整个过程可复现、可验证。支持 Claude Code、Codex CLI、OpenCode、Hermes 等主流 AI 编码工具，把模糊想法变成可靠代码库，大幅减少返工。
常见问题与排障 (2)
故障排除如何修复Windows上Ouroboros的'WinError 123'检查点错误？
将Ouroboros升级至0.40.0或更高版本。此版本会清理检查点文件名中的冒号及其他Windows保留字符（< > : " / \ | ? *），从而防止因无效NTFS字符导致的'WinError 123'错误。升级后无需手动处理。若无法升级，请暂时避免使用包含冒号的seed_ids，但这并非可靠修复方案。
故障排除如何修复在运行 Codex CLI 0.134+ 版本中的 'ooo interview' 时出现的 'legacy profile' 错误？
此错误因 Codex CLI ≥0.134.0 使用 profile‑v2 文件（如 ~/.codex/ouroboros‑frontier.config.toml）且拒绝 ~/.codex/config.toml 中的传统 [profiles.*] 表所致。修复工作已在 PR #1268 中进行。在合并之前，请手动迁移：1) 将每个 [profiles.ouroboros‑*] 块从 ~/.codex/config.toml 移至单独的文件 ~/.codex/ouroboros‑*.config.toml。2) 从 config.toml 中删除传统部分。或者，在 PR 合并后重新运行 ouroboros setup。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：在终端执行 curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | bash 一键安装
步骤2：打开你常用的 AI 编码工具（如 Claude Code），在会话内运行 ooo interview "我想实现一个任务管理 CLI"
步骤3：回答面试问题，Ouroboros 自动生成规范、执行并评估，最终输出可用代码
- 步骤1：在终端执行 curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | bash 一键安装
- 步骤2：打开你常用的 AI 编码工具（如 Claude Code），在会话内运行 ooo interview "我想实现一个任务管理 CLI"
- 步骤3：回答面试问题，Ouroboros 自动生成规范、执行并评估，最终输出可用代码
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
d890232e4fff81dbb9a9d6861c653b130ea96bcc204eafd4aae0b2098eb3fc72该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
在终端运行 ouroboros uninstall，将删除所有配置、MCP 注册和数据。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs