Atlas Skill：给 AI 编程助手造一个「代码归属层」

Skill超级捕获手技术创作者 2026-09-27 550 阅读

Atlas Skill：给 AI 编程助手造一个「代码归属层」

总结

Atlas（pacifio/atlas）是一个用 Rust 写的源码版本控制工具，专为多 Agent 并行协作场景设计。它解决的核心问题是：当 Claude Code、Codex、Cursor 同时在一个仓库里写代码，改动归属混乱、上下文无法跨 Agent 共享。Atlas 通过「检查点」（checkpoint）机制，把每次 Agent 运行的 prompt、工具调用和推理过程与 git commit 绑定，让「哪段代码是谁、为什么这样写」变得可查可溯。GitHub 约 6,800 星（截至 2026-09-21），每日新增约 186 星，持续活跃在 Trending 榜单。

功能与原则

Atlas 不是 git 的替代品，而是一层「面向 Agent 的归属层」。它的三条核心设计原则：

Commit 附带推理：git commit 只记 diff，Atlas checkpoint 记「这次 Agent 被喂了什么 prompt、调用了哪些工具、先尝试了什么方案又放弃了」，全部关联到同一笔 commit。
多 Agent 共享记忆：一个 Agent 做过的决策，自动流入下一个 Agent 的上下文，不需要人工传递。
本地优先：代码、笔记、Session 数据默认存在本机 SQLite，不上云；需要团队同步时可选组织同步功能。

认可度

GitHub Star：约 6,800（截至 2026-09-21），30 天增长 +5,600 星，日均 +186 星，增速稳定
GitHub Fork：700+
Trending 表现：2026-05-16 首次登榜，9 月 21 日排名第 18，累计在 Trending 出现 44 天
社区：GitHub 16 位贡献者，近 4 周 199 次 commit，维护活跃度较高
集成生态：支持 ACP（Agent Client Protocol），Claude Code、Codex、OpenCode 可直接接入

链接

GitHub：https://github.com/pacifio/atlas

原作者

Adib Mohsin（GitHub: pacifio），独立开发者，同时维护 Cersei（Rust Agent SDK）。Atlas 是他围绕「多 Agent 协作」这一新兴工作流打造的基础设施项目，定位清晰，迭代速度快（2026-09 单月发了 4 个版本）。

介绍

随着 Claude Code、Codex、Cursor 等 AI 编程助手逐步进入开发团队日常，一个新问题正在浮出水面：Agent 写的代码越来越多，但背后的推理过程全部丢失了。

传统的 git commit 只记录「改了什么文件、哪一行」，而 Agent 被喂了什么 prompt、调用了哪些工具、先尝试了什么方案又放弃——这些信息全部留在终端滚动缓冲区里，commit 之后无从追溯。三个月后看一段代码，只能看到「长这样」，不知道「为什么这样写」。

更复杂的是多 Agent 场景：同一个仓库里可能同时跑着 Claude Code 做功能、Codex 做重构、Atlas 内置 Agent 写测试，三个 Agent 各写各的，git log 里全是机器写的 commit message，分不清谁改了什么、为什么改。

Atlas 的解法是「检查点」（checkpoint）：每次 Agent 运行结束后，Atlas 把这次会话的 prompt、工具调用序列、最终 diff 打包成一个 checkpoint record，关联到 git commit。将来任何一个时间点，选中一个 commit 就能和它对话，询问「这次运行做了什么、为什么这样做」——不需要去翻原始终端记录。

第二条设计线是「共享记忆」。Atlas 维护一个本机向量索引，把项目中的决策、计划、文件变更和架构笔记持久化。当你在 Claude Code 和 Codex 之间切换时，下一个 Agent 自动从索引里拿到上一个 Agent 的上下文，不需要你重新解释项目背景。

特点

Checkpoint 追溯：每个 commit 链接回产生它的 Agent session，支持对话式查询（选 commit → 问「为什么这样写」）
多 Agent 并行：Claude Code、Codex、Atlas 内置 Agent（基于 Cersei Rust SDK）或任何 ACP 兼容 Agent，可同时跑在同一个仓库的不同工作区
语义化 @ 提及：在 prompt 里写 @文件名、@分支、@commit 或 @笔记，Atlas 在发送前在本地解析为实际内容，不依赖远程服务
共享记忆层：决策、计划、架构笔记在 Agent 之间自动流转，无需人工复制粘贴
本地 SQLite：Session 数据存在 .atlas/sessions.db，默认不上云，支持完全离线使用
Tauri 桌面端：Rust + TypeScript 技术栈，macOS（Apple Silicon / Intel）和 Windows（x64）有独立安装包，Linux 可从源码构建
安全清洗：Agent session 在落盘前自动清洗敏感信息（API Key、Token 等）

使用方法

安装（macOS）

curl -LsSf https://atlas.up/0.3.3/atlas_0.3.3_aarch64.dmg -o /tmp/atlas.dmg
open /tmp/atlas.dmg

安装（Windows）

从 github.com/pacifio/atlas/releases 下载 MSI 安装包，或：

irm https://atlas.up/0.3.3/atlas_0.3.3_x64_en-US.msi | iex

初始化项目

cd your-project
atlas init

接入 Agent

atlas agent add claude-code   # 注册 Claude Code
atlas agent add codex         # 注册 Codex
atlas run claude-code "add retry logic to the HTTP client"

查看改动归属

atlas diff claude-code   # 查看 Claude Code 这次运行改了哪些文件
atlas checkpoint list    # 列出所有检查点及关联的 Agent session

对话式回溯

在 Atlas 桌面端，选中任意一个 commit，可直接问：「这次运行为什么这样设计？」——Atlas 从 checkpoint 记录里拼出上下文回答。

使用场景与人群

适用场景

团队中多人各自跑不同 Agent（Claude Code / Codex / Cursor）并行开发，需要统一追踪改动
单人跨多 Agent 切换（中途从 Claude Code 换到 Codex），希望上下文自动衔接
技术负责人需要 review Agent 写的 PR，要看到「为什么这样写」而不是只看 diff
需要在 Agent 代码上做长期维护和知识积累的项目

目标用户

使用 Claude Code、Codex、Cursor 等编程助手的开发者
多 Agent 协作工作流的早期采用团队
对代码可追溯性有要求的技术负责人

输入与输出案例

案例一：多 Agent 并行开发

用户操作：
atlas run claude-code "implement user authentication"
atlas run codex "refactor the database layer"

输出：
commit a3f9c2d — claude-code — "implement user authentication"
commit b7d1e8f — codex — "refactor database layer"
atlas diff claude-code  → 显示 claude-code 改了 auth.rs、middleware.rs
atlas diff codex        → 显示 codex 改了 db.rs、schema.rs

两个 Agent 同时工作，commit 作者和 Agent session 一一对应，冲突时清晰定位「谁动了什么」。

案例二：Checkpoint 回溯

用户操作：
atlas checkpoint list
→ [a3f9c2d] claude-code · 2026-09-21 14:23 · "implement user authentication"

用户选中该 checkpoint，问：「这次为什么用 JWT 而不是 session？」
Atlas 从 checkpoint 记录里找到当时的 prompt 和 Agent 推理过程，回答：
「Prompt 要求支持跨域 API，Agent 判断 JWT 更适合分布式场景，放弃了 session 方案。」

不需要翻终端滚动记录，直接从 checkpoint 结构化数据中还原推理过程。

GitHub: https://github.com/pacifio/atlas

评论区

0 条评论

登录后可评论。