让代码库成为你的智能伙伴

GitAgent 将 AI 助手的配置、逻辑与记忆提取到可移植、可版本控制的定义中。只需定义一次，即可在任何环境中运行 —— 无论是 Claude、OpenAI、CrewAI 还是 OpenClaw，同一个仓库，适配任何运行时。

💡 核心理念：像编写代码一样管理你的 AI 助手。回滚提示词、分支测试、代码审查 —— 所有你熟悉的 Git 工作流，现在同样适用于智能体开发。

一个完整的 AI 助手仅需三个核心文件：

其他皆为可选。没有冗余配置，没有框架锁定。

当智能体成为代码库，以下架构模式自然浮现：

分支即审核：当 Agent 学习新技能或写入记忆时，自动开启分支并提交 PR，供人工审查后再合并
提交即历史：每次变更都是 Git 提交。回滚损坏的提示词、撤销错误技能、探索历史版本 —— 完整的撤销历史开箱即用
状态持久化：memory/runtime/ 目录存储 dailylog.md、key-decisions.md 等实时知识，跨会话保持执行上下文
确定性工作流：在 workflows/ 中用 YAML 定义多步骤流程，支持依赖排序与数据流模板
Git 即唯一状态源：计算环境无状态，所有事件（bootstrap、execute、checkpoint、teardown）提交至 runtime/<date>/<job-id> 分支，实现完整审计追踪与故障恢复
根级共享：仓库根目录的 context.md、skills/、tools/ 自动被所有子 Agent 共享，消除重复配置
环境晋升：像发布软件一样，通过 Git 分支将 Agent 变更从开发环境晋升至生产环境
知识图谱：knowledge/ 文件夹以层次化树结构存储实体关系与嵌入向量，支持运行时结构化推理

审计追踪：git diff 精确展示版本差异，git blame 追溯每一行配置的编写者与时间
版本标签：使用 v1.1.0 等标签标记稳定版本，生产环境可固定到特定标签，实现秒级回滚
职责分离：通过 agent.yaml 与 DUTIES.md 定义角色（maker、checker、executor、auditor）与冲突矩阵，gitagent validate 在部署前自动检测违规
秘钥隔离：API 密钥读取自本地 .env 文件（已被 .gitignore 排除），配置可分享，秘钥不外泄
生命周期钩子：在 hooks/ 目录定义 bootstrap.md 与 teardown.md，精确控制启动与停止行为

定义一次，导出到任何主流框架：

运行同样简单：gitagent run <github-url> 即可克隆仓库并立即启动 Agent，无需手动复制配置文件。

🌿 开放协作：Fork 任何公开的 Agent 仓库，自定义 SOUL.md，添加你的技能，然后通过 PR 将改进回馈上游 —— 用开源的方式协作构建 AI 智能体。

GitAgent by Lyzr