OpenGAP

这个 Agent 能做什么，适合哪些场景？

OpenGAP（Git Agent Protocol）是一套以 Git 仓库为载体的 AI Agent 定义标准，以及其参考命令行工具。一个最小 Agent 由 agent.yaml 清单和 SOUL.md 身份文件组成，并可扩展规则、技能、工具 schema、工作流、记忆、钩子、合规材料和子 Agent。CLI 可初始化模板、校验定义、展示信息、导入部分现有格式，并导出为系统提示词、Claude Code、OpenAI Agents SDK Python 等目标格式。它定义和转换的是 Agent 的身份、规则、工具 schema 与策略；编排状态机、实时工具执行、记忆 I/O 和迭代循环仍由目标运行时负责。

执行 npm 安装后的 opengap（gitagent 为兼容别名）时，opengap init --template 创建 minimal、standard、full 或 llm-wiki 模板。opengap validate 会按规范校验 Agent，附加 --compliance 时校验监管与职责分离配置；opengap audit 生成合规检查报告。opengap export --format <fmt> 将仓库中的 agent.yaml、SOUL.md 等定义导出为指定适配器格式，opengap import --from <fmt> <path> 支持 claude、cursor、crewai、opencode 导入，opengap run 可从 Git 仓库或本地目录经适配器运行定义。workflows/ 可用 YAML 编排 skill:、agent:、tool: 步骤，支持 depends_on、输入模板、条件和失败通知设置。

1. 希望把团队的代码审查 Agent 以 Git 管理，并在 CI 中执行 opengap validate 的工程团队。
2. 需要将同一套身份、规则和工具 schema 导出到 Claude Code、OpenAI Agents SDK 或纯系统提示词的 Agent 维护者。
3. 在金融合规场景中，需要声明 maker、checker 等角色冲突、人工监督和审计记录要求的团队。
4. 希望通过 extends 或 dependencies 复用基础 Agent、技能和子 Agent 定义的平台工程团队。
5. 准备把 Claude、Cursor、CrewAI 或 OpenCode 中已有 Agent 定义迁入版本化仓库的开发者。

如何安装或部署这个 Agent？

前提是 Node.js >= 18、npm 和 Git。全局安装：

npm i -g @open-gitagent/opengap

安装后可使用 opengap；gitagent 也会作为向后兼容别名安装。README 未要求 API 密钥作为创建、校验或导出定义的前置条件。

如何使用这个 Agent？

在目标 Git 仓库中创建第一个定义：

opengap init --template standard
opengap validate
opengap info
opengap export --format system-prompt

最小定义需保留 agent.yaml 和 SOUL.md。若需直接运行某个定义，可使用：

opengap run ./my-agent --adapter lyzr

也可将 Agent 定义与工作区分开：

opengap run --dir ./agents/reviewer --workspace ~/code/my-app --adapter claude -p "Review this repository"

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

[![FARS 评测](https://followagents.com/badge/opengap.svg?lang=zh)](https://followagents.com/zh/agents/opengap)

<a href="https://followagents.com/zh/agents/opengap"><img src="https://followagents.com/badge/opengap.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.5.0 v0.5.0 — Claude session continuation (--continue, --resume, --session-id) 2026-07-02
   发布说明摘录

   opengap run: session continuation for the claude adapter ```bash Continue the most recent session in the working directory opengap run -d ./my-agent -a claude -c -p "continue where we left off" Pin a session ID on first run, resume it later opengap run -d ./my-agent --session-id 3f9f74a6-6b7c-4a3e-9e1d-2f1f0a9b8c7d -p "Start the audit" opengap run -d ./my-agent --resume 3f9f74a6-6b7c-4a3e-9e1d-2f1f0a9b8c7d -p "Continue the audit" ``` New flags (claude adapter) - -c, --continue — continue the most recent Claude Code session in the working directory (pairs with --workspace) …

   在 GitHub 查看 ↗
2. v0.4.0 v0.4.0 — OpenGAP (rebrand from gapman) 2026-05-24
   发布说明摘录

   OpenGAP v0.4.0 — package and CLI renamed from gapman to opengap. Install: npm install -g opengap (or scoped @open-gitagent/opengap). The gitagent command stays as a backward-compat alias. Includes the financial_governance type fix and repository.url correction for provenance.

   在 GitHub 查看 ↗
3. v0.3.2 v0.3.2 — publish gapman both scoped and unscoped 2026-04-20
   发布说明摘录

   Publishes to both: - @open-gitagent/gapman (scoped) - gapman (unscoped alias, same contents) Either works: ```bash npm install -g gapman or npm install -g @open-gitagent/gapman ```

   在 GitHub 查看 ↗

常见问题