OpenGAP
用 Git 仓库定义、校验并导出可移植 AI Agent 的命令行标准。
- Star 数
- ★ 2.9k
- 最近更新
- 2 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API
- 开始前需要
- 典型场景
- 希望把团队的代码审查 Agent 以 Git 管理，并在 CI 中执行 opengap validate 的工程团队。
- 主要局限
- 仅 agent.yaml 有严格 schema；其他约定文件的质量和完整性仍依赖团队治理。
- 源码审查
- 51/100 · 缺口较多
这个 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、输入模板、条件和失败通知设置。
- 希望把团队的代码审查 Agent 以 Git 管理，并在 CI 中执行 opengap validate 的工程团队。
- 需要将同一套身份、规则和工具 schema 导出到 Claude Code、OpenAI Agents SDK 或纯系统提示词的 Agent 维护者。
- 在金融合规场景中，需要声明 maker、checker 等角色冲突、人工监督和审计记录要求的团队。
- 希望通过 extends 或 dependencies 复用基础 Agent、技能和子 Agent 定义的平台工程团队。
- 准备把 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 有哪些优点和局限？
- 以 Git 提交、分支、diff、标签和 PR 管理 Agent 定义，天然支持版本回退与审计追踪。
- agent.yaml、SOUL.md、RULES.md、DUTIES.md 等文件将身份、约束和职责政策拆分为可审阅的仓库资产。
- 提供 init、validate、audit、import、export、run 和 skills 命令，并列出多种导出或运行适配器。
- 对金融合规和职责分离提供明确字段、冲突矩阵、交接要求及 strict/advisory 执行模式。
- 仅 agent.yaml 有严格 schema；其他约定文件的质量和完整性仍依赖团队治理。
- 跨框架导出不迁移运行时编排、实时工具执行、记忆 I/O 或迭代循环，落地时仍要维护目标运行时。
- 使用 CLI 需要 Node.js >= 18、npm、Git 和本地文件系统；Git 依赖解析及远程仓库运行也会涉及网络访问。
- README 虽列出适配器，但未在提供材料中说明各适配器的功能一致性、认证流程或生产运行保障。
这个 Agent 与同类方案有什么区别？
与 Claude Code、OpenAI Agents SDK、CrewAI、LangGraph 等运行框架相比，OpenGAP 的定位是抽取并版本化 Agent 的身份层、规则、角色与工具 schema，而不是替代这些框架的运行时编排和执行机制。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|
| OpenGAP 当前 | 51 · 缺口较多 | ★ 2.9k | 2 个月前 | TypeScript | Codex · Claude Code · OpenAI API |
| DACA 智能体 AI 学习体系 | 38 · 缺口较多 | ★ 4.4k | 11 个月前 | Jupyter Notebook | OpenAI API |
| Agency Swarm 多智能体编排框架 | 45 · 缺口较多 | ★ 4.6k | 1 天前 | Python | OpenAI API |
| Gitagent | 44 · 缺口较多 | ★ 702 | 1 个月前 | Rust | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：项目提供了权限控制（如SOD角色权限）、用户确认（human-in-the-loop）、数据流透明（git diff/blame）、敏感数据处理（.env和.gitignore）、依赖安全（npm依赖列表）、外部影响（git操作）、回滚（git版本控制）和来源归属（git blame）。但这些都是文档描述，没有实际代码验证，且权限模型可能过于复杂，未明确最小权限原则。扣分原因：缺乏实际执行证据，权限设计可能过度。
证据显示：项目有自洽的规范（agent.yaml、SOUL.md等），依赖列表明确，但失败消息未详细说明。扣分原因：失败处理文档不足，依赖可用性未验证。
证据显示：项目面向多种受众（开发者、合规人员），定义了能力边界（skills、tools），触发条件（workflows中的triggers），环境适配（多适配器）。扣分原因：触发精度和边界定义在文档中较简略。
证据显示：信息架构清晰（目录结构），安装说明明确（npm install），命名稳定（opengap/gitagent别名），示例丰富（examples/），许可证MIT，版本号存在，维护责任有作者信息。扣分原因：已知限制未明确，变更日志缺失，维护责任仅作者名。
证据显示：输出可用（多种导出格式），边际价值高（解决框架碎片化），成本效益未量化。扣分原因：成本效益无数据支持。
证据显示：文档中有具体示例和模式，但缺乏独立验证，事实与推断未明确区分。扣分原因：声明多为断言，无测试结果支撑。
- 文档中宣称的合规特性（如FINRA、SEC）未经验证，可能只是营销声明。
- 权限模型（SOD）可能过于复杂，实际执行时可能违反最小权限原则。
- 依赖安全未审计，存在已知漏洞风险。
- 发布者身份未验证，维护责任不明确。