gitagent | 让你的仓库成为你的 Agent

这是一个不绑定特定框架、Git 原生（git-native）的 AI Agent 定义标准。克隆一个仓库，即刻获得一个 Agent。

为什么选择 gitagent

每个 AI 框架都有其独特的结构。目前还没有一种通用的、可移植的方法来定义 Agent，使其能够跨 Claude Code、OpenAI、LangChain、CrewAI 和 AutoGen 使用。gitagent 解决了这个问题。

• Git 原生 — 内置版本控制、分支管理、差异比对（diffing）和协作功能
• 不绑定框架 — 通过适配器（adapters）可导出至任何框架
• 符合合规性 — 对 FINRA、联邦储备委员会、SEC 和职责分离（segregation of duties）提供一流支持
• 可组合性 — Agent 可以扩展、依赖其他 Agent 并向其委托任务

标准规范

让你的仓库成为你的 Agent。将这些文件放入任何 Git 仓库，它就变成了一个可移植、不绑定框架的 Agent 定义——其他所有内容（CLI、适配器、模式）都构建于此之上。

my-agent/
│
│   # ── 核心标识（必需） ──────────────────────────
├── agent.yaml              # 清单文件 — 名称、版本、模型、技能、工具、合规性
├── SOUL.md                 # 标识、个性、交流风格、价值观
│
│   # ── 行为与规则 ──────────────────────────────────
├── RULES.md                # 硬性约束、必须执行/禁止执行项、安全边界
├── DUTIES.md               # 职责分离策略与角色边界
├── AGENTS.md               # 与框架无关的兜底指令
│
│   # ── 能力 ──────────────────────────────────────
├── skills/                 # 可复用的能力模块 (SKILL.md + 脚本)
│   └── code-review/
│       ├── SKILL.md
│       └── review.sh
├── tools/                  # 兼容 MCP 的工具定义 (YAML 模式)
├── workflows/              # 多步骤流程/剧本
│
│   # ── 知识与记忆 ────────────────────────────────
├── knowledge/              # Agent 可查阅的参考文档
├── memory/                 # 跨会话持久化记忆
│   └── runtime/            # 实时 Agent 状态 (dailylog.md, context.md)
│
│   # ── 生命周期与运维 ───────────────────────────────────
├── hooks/                  # 生命周期事件处理器 (bootstrap.md, teardown.md)
├── config/                 # 特定环境的覆盖配置
├── compliance/             # 合规性凭证
│
│   # ── 组合 ───────────────────────────────────────
├── agents/                 # 子 Agent 定义 (递归结构)
│   └── fact-checker/
│       ├── agent.yaml
│       ├── SOUL.md
│       └── DUTIES.md       # 该 Agent 的角色、权限、边界
├── examples/               # 校准交互 (few-shot 少样本提示)
│
│   # ── 运行时 ───────────────────────────────────────────
└── .gitagent/              # 运行时状态 (已被 gitignored)

仅需两个必需文件：agent.yaml（清单）和 SOUL.md（身份）。其他文件均为可选——按需添加，无需则忽略。

模式

当你将 Agent 定义为 Git 原生的文件系统时，会涌现出以下架构模式。

面向 RL Agent 的人机协同（Human-in-the-Loop）

当 Agent 学习新技能或写入内存时，它会创建一个分支并提交 PR，等待人类审核后再合并。

职责分离（SOD）

任何单一 Agent 都不应全程控制关键流程。通过 agent.yaml + DUTIES.md 定义角色（maker 创建者、checker 审核者、executor 执行者、auditor 审计者）、冲突矩阵（哪些角色不能由同一 Agent 担任）以及移交工作流。验证器会在部署前捕获违规行为。

compliance:
  segregation_of_duties:
    roles:
      - id: maker
        description: 创建提案
        permissions: [create, submit]
      - id: checker
        description: 审核并批准
        permissions: [review, approve, reject]
    conflicts:
      - [maker, checker]         # 创建者不能批准自己的工作
    assignments:
      loan-originator: [maker]
      credit-reviewer: [checker]
    handoffs:
      - action: credit_decision
        required_roles: [maker, checker]
        approval_required: true
    enforcement: strict

实时 Agent 记忆

memory/ 文件夹包含一个 runtime/ 子文件夹，Agent 可在此写入实时知识（如 dailylog.md、key-decisions.md 和 context.md），从而在不同会话间保持状态持久化。

Agent 版本控制

你对 Agent 所做的每一次更改都是一个 Git 提交。