0xUrsanomics/utopia-os

# Utopia OS **一个开放框架，用于在 coding-agent CLI 之上运行持久、自我调节的 AI 操作系统。** 大多数人将 AI 助手用作无状态的聊天框：每次会话都从零开始，没有任何积累，而且因为没有任何限制，助手会自信地去做一些不可逆的事情。Utopia OS 恰恰相反。它是将通用 coding agent 转变为*操作员*的记忆、技能、安全和多 agent 支架——这种操作员能够跨会话记忆，遵循特定语气，对自身的高风险操作进行把关，并在不丢失上下文的情况下将工作交接给子 agent。 这个仓库是**架构和可复用的机制**，剔除了所有个人和业务内容。它是一个骨架，由你来填充自己的记忆、技能和集群。 ## 它为何存在 coding agent 是一个强大的 runtime，但其周围没有操作系统。Utopia OS 添加了使长期运行的自主工作安全且持久的要素： - **持续积累的记忆。** 分层存储（始终加载的核心 → 按需召回 → 语义归档），以便 agent 知道你是谁以及上个月决定了什么，而无需每次轮次都重新阅读所有内容。 - **操作状态的单一写入路径。** 一个存储，一个 mutator，记录每一次更改——这样“我们处于什么模式 / 什么是当前活跃的 project / 还剩多少预算”就不会在分布式的进程集群中产生漂移。 - **安全优先的关卡。** 挂起注册表、自动复合计数器、skill linter 和一个 CONFIRM gate，强制在执行安装、设置编辑或任何不可逆操作之前进行人工检查。 - **知识 pipeline。** 原始输出 → review gate → canonical graph，这样 agent 自己的草稿就不会污染事实来源。 - **多 agent 协议。** 在 persona 之间和独立的 agent 租户之间进行结构化的交接，具有深度限制和记忆隔离，因此委派任务不会无序扩张。 - **生存层。** 会话引导的“降落伞”和主动交接块，确保任务中途的 context 压缩或崩溃能够干净地恢复，而不是丢弃正在进行的任务。 ## 包含的内容 | 路径 | 它是什么 | |---|---| | `docs/` | 架构文档，每个子系统一份设计文档。从这里开始看。 | | `memory/templates/` | 记忆系统的空骨架（语气准则、用户模型、索引、交接）。 | | `scripts/security/` | 安全关卡（挂起注册表、复合计数器、skill linter、发送守卫）。 | | `scripts/memory/` | 状态存储（SSOT）、召回和记忆机制。 | | `scripts/cockpit/` | 用于整个系统的零依赖、只读 localhost 仪表盘。 | | `skills/` | 可复用的 agent 工作流（保存、范围界定、critic、review-gate、dreaming 等）。 | | `skills-shared/` | 基于公共研究构建的跨 persona 技能（anti-slop、sycophancy guard、premortem）。 | | `CLAUDE.md` | 将所有内容连接在一起的 system-prompt 骨架。 | ## 特意未包含的内容 没有真实的记忆内容，没有业务数据，没有个人信息，也没有密钥。Utopia OS 是作为一个干净的骨架构建的，而不是经过过滤的转储——每个文件在编写或移植时都确保不包含操作者的身份信息。如果你要采用它，你需要带入自己的内容。 ## 入门指南 1. 阅读 `docs/ARCHITECTURE.md` 以了解整个系统的概貌，然后再看子系统文档。 2. 复制 `CLAUDE.md` 和 `memory/templates/` 骨架，并用你自己的语气和用户模型填充它们。 3. 将安全关卡连接为 hooks（参见 `docs/security-gates.md`）。 4. 逐步采用技能——每个技能都位于 `skills//SKILL.md`（标准的 Agent Skills 格式）。要在 Claude Code 中使用某项技能，请将其文件夹复制到你的 `.claude/skills/` 中。共享的辅助脚本位于 `scripts/` 下，并通过相对于仓库根目录的路径进行引用。 ## 致谢 Utopia OS 借鉴了许多开源工作和公共研究中的模式、技能和参考包，并依赖于 token 效率工具（TOON、RTK、caveman）以实现低成本的运行。请参阅 [CREDITS.md](CREDITS.md) 获取完整列表。如果你的作品在此处被使用且未被致谢，请提交一个 issue。 ## 许可证 MIT © 0xUrsanomics。使用它，fork 它，让它成为你的。

标签：防御加固