Atlas——重新拥有编码代理的AI上下文
一个命令给每个编码代理都提供相同的文件结构,repo内存,以及AGENTS.md——
财务报告和审定财务报表 atlas doctor 在CI中用被冻结的出入境密码来核查这个结构.
每个编码代理都会在会话间忘记你的回放,每个工具都想要自己的配置文件. 你重新阐释建筑,词汇,“不要碰那个”列表——每个代理,每个会话,永远.
图集(按 空虚) 给寄存器一个所有文件的位置: Claude Code, Codex, Cursor 的统一文档结构和普通文件工作空间, 以及任何读取的文件 一般事务人员(其他职等) 参与——承诺在公关中加以审查,并通过确定性CLI来检查漂移情况.
- ⚡ 一个命令 —— 说
npx @blazity-atlas/core init脚手架 AGENTS.md, CLAUDE.md,和一个完整的.ai/工作空间 - 🗂️ 万事俱备 ——规划,研究,决定,发展成果评估,内存,词汇,以及可预见,自定义地点的审查判断
- 🤝 每个特工,一个背景 – Claude Code, Cursor, Codex, Copilot, 和双子座 CLI 共享相同的 repo 拥有的文件
- 🧩 善于发挥技能 第三方和定制技能通过文件输出
.ai/config.json而不是创建新文件夹 - 📦 以你拥有的东西为基础 ——由配置驱动的路径别名采用您现有的docs文件夹而不是替换它们
- 🩺 机器检查 —— 说
atlas doctor以冻结的出站码验证CI结构;--fix确定 - 🔒 没有什么留下你的回扣 ——没有遥测,没有网络呼叫,只有一个依赖性,只有普通文件
特征展示
简短演示 atlas init,即时交接 atlas doctor。 。 。 .
快速启动
npx --yes @blazity-atlas/core@latest init
一个运行的脚手架将工作空间——配置,词汇,内存,文物目录,两个管理技能,AGENTS.md和CLAUDE.md的入门点,以及代理的同名链接——然后打印出一个即时相接的交接快取. 您自己的编码代理从那里接收: 它检查寄存器, 并用特定项目的事实填充工作空间 .
在终点站, init 交互运行: 它询问工作空间应住在哪里( 默认) .ai),在写入前预览每个文件,并且可以发射被检测到的代理CLI(claude, (中文(简体) ), codex, (中文(简体) ), cursor-agent与交接即时.
安全运行于已有的还原
这是你两分钟内可以核实的行为,而不是承诺:
- 拒绝肮脏的工作树.
init财务报告和审定财务报表doctor --fix当您有未承诺的更改(并命名违法文件)时停止;--force是明确的覆盖. - 保留你的内容. 现有
AGENTS.md得到一个栅栏管理区块附加; 所有你写的都留下。 修理从不触及管理区块外的内容. - 同上,注:. 一秒钟
init指纹Already up to date — nothing to write. - 可预览.
init --dry-run显示每一个计划书写和触摸什么. - 仅限普通文件 . 没有数据库, 没有守护进程; 唯一的网络呼叫是明确引用的更新检查( N)
atlas update编号 :doctor --check-updates) (中文(简体) ). Uninstall = 删除工作空间目录, 管理区块AGENTS.md,还有三个韵母.
一个结构,里面的一切
脚手架是无聊的部分。 关键在于你工作时所收集的东西:计划、研究、发展成果评估、词汇、记忆和复审裁决——在可预见的地点,代理商通过 .ai/config.json,而不是溶入聊天历史.
这条路线并不只是阿特拉斯系统 管理组图集写入 AGENTS.md 告诉任何代理人——以及它所操作的任何技能,第三方或习惯——在写作前通过配置解决文物目的地. 一个规划技能的计划在计划目录中着陆,一个研究技能的研究报告,一个评论对结果的判断:一棵树,不管哪个工具写下来.
这个寄存器运行在Atlas上. 它自己的工作空间是演示:
.ai/LANGUAGE.md- 词汇 避免 栏中编码真实决定的 (“Template QQ Preset”,禁止的后继名称)..ai/memory/lessons.md获得的教训,例如: “在共享代理名称空间中review与克勞德·克勞德(Claude Code)的内在PR-review技巧在实际操作中相撞".ai/decisions/adrs/——创纪录的发展成果评估拒绝了选项,而不仅仅是赢家..ai/results/- 复审法院的裁决atlas-review进程门.
如果您的回购已经保留了常规位置的文档( N)docs/adrs, (中文(简体) ), docs/specs,...),Atlas通过配置驱动将其映射入工作空间 pathAliases 而不是发明一个并行的文件系统—— doctor --fix 执行动作, 配置会保留未来的路由 .
doctor 在 CI 语句中
- name: Atlas structural gate
run: npx --yes @blazity-atlas/[email protected] doctor # pin the version your workspace was scaffolded with
出口代码是冻结合同:
| 退出 | 含义 |
|---|---|
0 | 工作空间干净——建议绝不影响退出代码 |
1 | 可修复的漂移—— atlas doctor --fix 修理它 决定性的 |
2 | 需要人类的手动冲突 |
顾问(设置待决,空置内存,上下文过大)告知,永远不失败建设. doctor --json 将结果发布为用于脚本的结构化数据。 将版本绑起而不是 @latest: 管理的技能文件是字节对比的, 因此更新软件包并运行 doctor --fix 属于同一变化.
上下文大小的咨询监视文件代理实际加载—— AGENTS.md, (中文(简体) ), CLAUDE.md,词汇,内存,决定,管理技能——对照由有文献记载的代理上限提供的Heuristic字符预算(例如,Codex默认读取的项目docs最多32 KiB). 它们是紧凑的提示,而不是模式限制。 当一起火, atlas doctor --handoff context-size 打印任何代理的安全清理提示,并 atlas-compact 管理技能运行全循环:与 CLI 进行测量,提出每个文件的计划,应用经批准的编辑,重新运行 doctor 证明之前/之后.
更新
atlas update 检查 npm 的更新发布——唯一触及网络的Atlas命令,并且只有在运行时——并打印被绑定的升级命令. doctor --check-updates 运行与非屏蔽咨询相同的检查. doctor 自己从不上网,所以CI 保持决定性和离线.
工作空间记录了它是如何写的,和 doctor 使用两种记录 :
config.json携带atlasVersion,上次写工作空间的软件包版本。 最新的CLI报告aatlas-version-behind咨询直到您运行doctor --fix; 较老的CLI 点击 anatlas-version-ahead手动冲突,而不是静悄悄地返回新管理的文件(--force是明确的覆盖.atlas.lock.json记录每个管理技能文件的内容基线。 与软件包不同但符合其基线的文件从未在本地被触碰过,所以--fix更新它。 与两者不同的文件是故意定制:doctor报告acustomized-skill咨询和--fix别管它 继续定制doctor --adopt-skills(只有在后期发布会改变这种技能时,咨询才会返回),或用doctor --fix --reset-skills。 。 。 .
锁文件存在前的工作空间脚手架将旧技能内容归类为定制的一次——运行 doctor --fix --reset-skills 升级后, 如果您从未定制管理技能 .
导致判决的复审
第二个管理技能, atlas-review,将人工智能协助的工作通过五个模式进行——摄取、计划、评论、门、尸检——并将其判决(通过/有条件的通行证/失败,有证据、风险和业主)写入 .ai/results/,下一个特工运行的地方 和下一个人类能找到它。 没有留下文物的检讨不算作检讨.
Claude 代码用户运行 /atlas-review。任何其他代理人从一个指令得到相同的行为: "读 .ai/skills/atlas-review/SKILL.md" (中文(简体) )。 。 。 .
和你的经纪人一起工作
阿特拉斯写道: 一般事务人员(其他职等) 标准作为其切入点,所以大多数代理需要零配置:
| 探员 | 如何取出阿特拉斯系统 |
|---|---|
| 克劳德代码 | CLAUDE.md 进口 AGENTS.md; 技能通过 .claude/skills 符号链接或插件 |
| 代码 | 读取 AGENTS.md 本土 |
| 光标 | 读取 AGENTS.md 土生土长; .cursor/skills 提供同义链接 |
| GitHub 副驾驶 | 读取 AGENTS.md 在编码代理和 VS 代码中 |
| 双子座CLI | 一个设置: contextFileName: "AGENTS.md" |
| 还有什么 | 1个指令:"读取AGENTS.md,通过.ai/config.json解决路径" |
Claude代码用户也可以通过市场安装:
/plugin marketplace add Blazity/atlas
/plugin install atlas@blazity
/atlas:atlas-setup
范围和非目标
阿特拉斯核心舰今日有两种出入口:
- 结构门 —— 说
doctor上面有冻结的出厂密码. - 进程门 —— 说
atlas-review基于证据的判决 写在工作空间里.
没错 没有 运行您的测试, evals, 或政策检查( 执行门是标准点的下一个位置, 而不是Core今天所做的), 它不是一个代理运行时间, 它不生成代码 .
隐私
CLI在本地运行,运行时不进行网络通话,不发送遥测,而且完全有一个依赖性(CLI)@ clack/ 瞬间 用于交互式终端 UI). 它所写的都是你仓库里的普通文件 脚手架文件规则还要求耐用文物保持去个人化——记忆是安全的,可以承诺,也可以安全地发表.
所需资源
20号节点和Git仓库 macOS 和 Linux 支持; Windows 未测试.
使用Atlas系统建造
Blazity根据Atlas标准制定:
- 阿特拉斯夏娃启动器 用于生产型制剂的起动单雷波
- Next.js 迁移插件 ——网站 下个.js 迁移,并有建筑大门和可视化验证
- AI 工作流程 ——问题 ——计划 ——执行 ——审查的公关代理工作流程
捐款
见 捐款额错误报告 atlas doctor 由于括号内的查找代码,输出已可分解。 安全报告通过 警卫。 。 。 .
许可证
Atlas系统由 空虚 ——我们自己的AI工具背后的标准. 更多时间 blazity.com/阿特拉斯语。 。 。 .