OpenGAP | 让你的代码仓库成为智能体

opengap — OpenGAP CLI，发布于 @open-gitagent/opengap。此前曾发布为 @open-gitagent/gapman 和最初的 @open-gitagent/gitagent；为了向后兼容，gitagent 命令仍可作为别名使用。

OpenGAP (Git Agent Protocol) 是一个框架无关、Git 原生的 AI 智能体定义标准。克隆一个仓库，即刻获得一个智能体。opengap 是其参考 CLI 实现。

为什么选择 OpenGAP

目前的每个 AI 框架都有各自的结构。在 Claude Code、OpenAI、LangChain、CrewAI 和 AutoGen 之间，缺乏一种通用且可移植的智能体定义方式。gitagent 解决了这个问题。

• Git 原生 — 内置版本控制、分支管理、差异比对 (diffing) 和协作功能
• 框架无关 — 通过适配器 (adapters) 可导出到任何框架
• 合规就绪 — 对 FINRA（美国金融业监管局）、美联储、SEC（美国证券交易委员会）及职责分离（Segregation of Duties）提供一流支持
• 可组合 — 智能体可以扩展、依赖并委派任务给其他智能体

标准规范

让你的代码仓库变成智能体。将这些文件放入任何 git 仓库中，它就变成了一个可移植的、框架无关的智能体定义——其他一切（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/              # 智能体可参考的文档
├── memory/                 # 持久化的跨会话记忆
│   └── runtime/            # 实时智能体状态 (dailylog.md, context.md)
│
│   # ── 生命周期与运维 ───────────────────────────────────
├── hooks/                  # 生命周期事件处理器 (bootstrap.md, teardown.md)
├── config/                 # 特定环境的配置覆盖
├── compliance/             # 合规性凭证
│
│   # ── 组合 ───────────────────────────────────────
├── agents/                 # 子智能体定义 (递归结构)
│   └── fact-checker/
│       ├── agent.yaml
│       ├── SOUL.md
│       └── DUTIES.md       # 该智能体的角色、权限、边界
├── examples/               # 校准交互 (Few-shot 示例)
│
│   # ── 运行时 ───────────────────────────────────────────
└── .gitagent/              # 运行时状态 (已被 gitignore 忽略)

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

模式

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

针对 RL (强化学习) 智能体的人工介入 (Human-in-the-Loop)

当智能体学习新技能或写入记忆时，它会开启一个分支并创建 PR，供人类在合并前进行审查。

职责分离 (Segregation of Duties, SOD)

没有任何单一智能体应该完整控制一个关键流程。通过 agent.yaml 和 DUTIES.md 定义角色（maker 创建者、checker 检查者、executor 执行者、auditor 审计者）、冲突矩阵（哪些角色不能由同一智能体担任）以及交接工作流。验证器会在部署前捕获违规行为。

compliance:
  segregation_of_duties:
    roles:
      - id: maker
        description: Creates proposals
        permissions: [create, submit]
      - id: checker
        description: Reviews and approves
        permissions: [review, approve, reject]
    conflicts:
      - [maker, checker]         # maker cannot approve own work
    assignments:
      loan-originator: [maker]
      credit-reviewer: [checker]
    handoffs:
      - action: credit_decision