GitAgent by Lyzr
GitAgent:基于 Git 的原生 AI 智能体开放标准与版本管理框架
GitAgent 是一项专为 AI 智能体定义的 git 原生、框架无关开放标准。它允许开发者将整个 Git 仓库转化为智能体,集成版本控制、分支管理、PR 协作等功能。GitAgent 支持将配置导出至 Claude Code、OpenAI、CrewAI 等主流平台,并内置合规性审计、SkillsFlow 自动化流及多层级技能系统,旨在通过 Git 生态提供高度可追溯、可协作且安全稳定的 AI 智能体开发与运行环境。
2026-03-22
--K
GitAgent by Lyzr 产品信息
GitAgent:开启 Git 原生 AI 智能体的新时代
GitAgent 是一个革命性的开源标准(v0.1.0),它将 Git 仓库 直接转变为 AI 智能体。作为一种框架无关的开放协议,GitAgent 允许开发者利用 Git 的版本控制、分支协作和拉取请求(PR)等特性来定义、版本化和运行 AI 智能体。无论你使用的是 Claude Code、OpenAI 还是 CrewAI,GitAgent 都能提供统一的定义标准,真正实现“克隆仓库,即获智能体”。
什么是 GitAgent?
GitAgent 是由 Team @Lyzr 维护的一种 Git 原生 AI 智能体标准。它的核心理念是“你的仓库就是你的智能体”。通过在仓库中配置特定的文件结构(如 agent.yaml、SOUL.md 等),GitAgent 能够将复杂的 AI 逻辑、技能(Skills)和内存(Memory)存储在受版本控制的文件系统中。
这意味着,对智能体提示词(Prompts)的每一次修改都是一次 Git 提交,每一次技能的升级都可以通过分支进行预览和回滚。GitAgent 不仅仅是一个工具,它为 AI 智能体设计模式提供了坚实的基础设施。
GitAgent 的核心特性 (Features)
1. Git 原生与版本化管理
- 版本控制:智能体的每一次变更都对应一个 Git Commit,支持完整的回滚历史。
- 分支部署:利用 Git 分支(dev -> staging -> main)像发布软件一样推送智能体变更。
- 差异审计:通过
git diff精确查看智能体版本的变化,使用git blame追踪每一行指令的作者。
2. 框架无关与广泛适配 (Adapters)
GitAgent 定义一次,即可导出至多种运行时环境:
- Claude Code: 导出为包含技能和合规性提示的
CLAUDE.md。 - OpenAI Agents SDK: 自动生成带有工具存根的 Python 代码。
- 其他支持: 包括 CrewAI、OpenClaw、Lyzr Studio、Nanobot 及 GitHub Models。
3. SkillsFlow 确定性工作流
通过 YAML 定义多步骤工作流,链式调用技能(Skill)、智能体(Agent)和工具(Tool)。支持数据流模板 ${{ }} 和基于 depends_on 的顺序执行,确保复杂任务的确定性。
4. 实时智能体内存与知识树
- 内存持久化:在
memory/文件夹中记录执行状态、关键决策和上下文。 - 知识树:
knowledge/文件夹存储实体关系和嵌入数据,供智能体运行时推理。
5. 企业级合规性 (Compliance)
内置对 FINRA、SEC、Federal Reserve 等监管框架的支持。通过 gitagent audit 生成合规性报告,支持风险分级、职责分离(SOD)验证和审计日志留存。
常见应用场景 (Use Case)
- RL 智能体的人机协作:当智能体学习新技能或写入内存时,自动开启分支和 PR,待人类审查合并后再执行。
- 无状态计算与状态追踪:利用临时计算资源运行智能体,但将每一个关键事件(如 checkpoint)提交到 Git 分支,实现故障恢复和确定性回放。
- 单体仓库共享上下文:在 Monorepo 根目录下放置技能和工具,供仓库内所有子智能体共享,消除重复。
- 智能体分叉与混剪:Fork 任何公开的 GitAgent 仓库,自定义
SOUL.md,添加个人技能,并向原作者贡献代码。
如何使用 GitAgent (How to Use)
快速开始步骤
- 安装 CLI:
npm install -g gitagent - 初始化项目:
gitagent init --template standard - 验证配置:使用
gitagent validate检查 schema 完整性。 - 运行智能体:
# 从远程 GitHub 仓库运行智能体 gitagent run -r https://github.com/user/repo -a claude
核心文件定义
- agent.yaml: 定义名称、版本、首选模型(如 Claude 3.5 Sonnet)及工具列表。
- SOUL.md: 描述智能体的人格、核心指令和运行逻辑。
- SKILL.md: 定义特定的技能模块,包含允许使用的工具和指令。
常见问题解答 (FAQ)
Q: GitAgent 与其他 AI 框架有何不同? A: GitAgent 侧重于标准和管理层。它不取代现有框架,而是提供一种跨框架的定义方式,让智能体具备 Git 赋予的版本控制和协作能力。
Q: 它是开源的吗? A: 是的,GitAgent 是一个遵循 MIT 协议的开放标准,由 Shreyas Kapale 创建并由 Team @Lyzr 维护。
Q: 如何管理 API 密钥等敏感信息? A: GitAgent 遵循最佳实践,通过
.gitignore排除本地.env文件。智能体配置可共享,但密钥保留在本地。
Q: 如何确保智能体的安全性? A: GitAgent 提供了职责分离(SOD)检查。例如,可以定义制作、检查、执行和审计四种角色,
gitagent validate在部署前会自动捕获违规行为。








