项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2985
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Node.js 与 npm(README 使用 npm 全局安装)
- 已安装 Git,并有一个可用于存放智能体定义的 Git 仓库
- 可选:目标适配器对应的框架环境(README 示例中为 lyzr、claude)
安装与启动步骤
-
1安装全局 CLI
用 npm 全局安装 opengap 的官方 CLI 包,安装后同时提供 gitagent 别名命令。
npm i -g @open-gitagent/opengap -
2创建智能体定义
在任意 Git 仓库根目录放入 agent.yaml 与 SOUL.md,仓库即成为框架无关的智能体定义。
-
3编写核心清单
在 agent.yaml 中声明 name、version、model、skills、tools、compliance 等核心身份信息。
-
4用适配器运行
把智能体目录传给 run 子命令,用 --adapter 指定目标框架,例如 lyzr。
opengap run ./my-agent --adapter lyzr -
5指定工作区运行
用 --dir 指向智能体定义,--workspace 指向被操作的代码仓库,-p 传入提示词。
opengap run --dir ./agents/reviewer --workspace ~/code/my-app --adapter claude -p "Review this repository"
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
agent.yaml | 是 | 智能体清单文件,定义核心身份与能力,缺失则不是合法智能体定义 | agent.yaml |
name | 是 | agent.yaml 中的智能体名称字段 | reviewer |
version | 否 | agent.yaml 中的版本号字段,配合 Git 做版本管理 | 1.0.0 |
model | 否 | agent.yaml 中声明所使用的模型 | claude-sonnet |
skills / tools | 否 | 声明智能体可用的技能与工具 | skills: [review] |
compliance | 否 | 合规声明字段,README 提到支持 FINRA、SEC 等合规要求 | compliance: [SEC] |
如何确认成功
执行 opengap run 后若命令正常返回并输出智能体执行结果、无报错,即表示运行成功。
常见问题
Q:opengap 和 gitagent 是同一个命令吗?
A:是。CLI 包现名为 @open-gitagent/opengap,安装时会同时装上一个向后兼容的 gitagent 别名命令,功能一致。
Q:包名以前叫什么?
A:早期为 @open-gitagent/gitagent,随后是 @open-gitagent/gapman,现在为 @open-gitagent/opengap。
Q:怎么在不同框架之间复用同一个智能体?
A:智能体定义是框架无关的,运行或导出时用 --adapter 指定目标框架即可,README 示例使用了 lyzr 和 claude。
Q:智能体定义必须放在哪个目录?
A:README 未限制目录,只要目录内包含 agent.yaml 等定义文件,通过 opengap run 的路径参数指向它即可。
注意事项
- agent.yaml 是必需的核心身份文件,README 标注为 required。
- 可用 git 分支 dev → staging → main 逐环境推进智能体变更,像发布软件一样管理。
- README 未给出端口、环境变量或密钥配置,请勿自行添加。
核心亮点
- 框架无关,一套标准适配多种智能体框架,避免厂商锁定
- 基于 Git 原生工作流,天然支持版本控制、分支和协作
- 声明式定义技能和工具,降低智能体配置复杂度
不足之处
- 项目处于成长早期,生态和工具链尚不完善
- 文档和社区支持待观察
适用场景
- 团队需要跨框架共享和复用 AI 智能体配置
- 希望将智能体定义纳入 Git 版本控制流程
- 构建可组合、可扩展的智能体技能库
替代项目
Agent Protocol、OpenAI Agents SDK、LangChain
上一篇:MiroFlow
下一篇:Vibe-Skills
同类项目推荐
memex
开源
让 AI 编程代理拥有跨会话的长期记忆,无需数据库,纯 Markdown + Git 同步。
Zettelkasten-based persistent memory for AI coding agents. Works with Claude Code, C···
deep-researcher-agent
开源
接上企业数据,让 AI 自动做深度调研出结论
The NVIDIA Deep Researcher Agent Blueprint is an open reference example for building···
wx-assist
开源
本地微信 AI 助手,群聊摘要、关键词提醒、语义搜聊天
「摘星」· 微信助手 — AI Agent 智能助手 / AI 群聊摘要 / 关键词即时提醒 / 公众号摘要···
openmcp-client
开源
在 VS Code 里一站式开发、调试和测试 MCP 服务器,省去切换工具的麻烦。
All in one vscode plugin for mcp developer
n8n-claw
开源
用 n8n 可视化搭建自主 AI 代理,一个脚本搞定部署
OpenClaw-inspired autonomous AI agent built entirely in n8n. Adaptive RAG-powered me···
AgentDock
开源
拖拽编排 AI 代理,快速从原型到生产部署
Framework retired. Prompts and document generators moved to AgentDock/prompt-library···
claudette
开源
给 Claude Code 配上好帮手,桌面端轻松编排智能体
Claude's missing better half — a companion tool for Claude Code usage.
LocalAGI
开源
本地跑自主AI,隐私安全不花钱
LocalAGI:Locally run AGI powered by LLaMA, ChatGLM and more. | 基于 ChatGLM, LLaMA···
moltis
开源
一个二进制文件,自托管安全智能体,支持多平台和多模型。
A secure persistent personal agent server in Rust. One binary, sandboxed execution, ···
