Skillppx logo

Gitrama — Git History Intelligence

基于AI的Git历史智能分析，支持语义搜索、智能提交和分支命名。

已扫描
适合谁
需要高效管理Git历史的开发者、团队协作中频繁提交代码的工程师
不适合谁
不熟悉Git命令行的初学者、对AI依赖敏感或无网络环境的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @ahmaxdev/gitrama
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

name: gitrama

description: >

基于 AI 的 Git 历史智能分析工具。当用户询问 Git 历史、提交信息、分支名称、项目洞察、代码溯源，或希望了解代码库中发生了什么时使用。

触发关键词包括："git history"、"commit message"、"branch name"、"who changed"、"what happened"、"repo summary"、"code archaeology"、"semantic search git"、"generate commit"、"smart commit"、"git log analysis"、"contributor insights"。

version: 1.0.0

homepage: https://gitrama.ai

metadata:

openclaw:

emoji: "🌿"

requires:

bins:

- git

- pip

binsAnyOf:

- python3

- python

install:

pip:

- gitrama

Gitrama — Git 历史智能分析

Gitrama 是一个命令行工具，为你的 Git 历史注入 AI 驱动的语义搜索与智能分析能力。它内置了 AskGIT —— 一个能理解整个代码仓库上下文的 AI 助手。

所有 AI 处理均通过 api.gitrama.ai 在服务端完成，无需配置 API 密钥，安装后即可直接使用。

功能特性

1. AskGIT — 语义化 Git 历史对话

以自然语言向仓库提问：

  • “上个月对认证模块做了哪些修改？”
  • “API 层的主要贡献者是谁？”
  • “总结最近 20 次提交”
  • “v1.0 到 v2.0 之间有哪些破坏性变更？”

命令： gtr chat

AskGIT 会自动调用 10 次 Git 子进程命令（获取分支信息、最近提交、差异内容、贡献者、文件树结构等），将上下文发送至 api.gitrama.ai 进行智能分析。

2. 智能提交信息生成

根据已暂存的更改自动生成符合规范的提交信息：

  • 分析 git diff --staged 的内容
  • 生成格式正确的常规提交（feat:, fix:, docs: 等）
  • 支持项目自定义的提交规范

命令： gtr commit

3. 分支名称生成

根据任务描述生成清晰、规范的分支名：

  • 符合 Git 分支命名规范
  • 包含类型前缀（feature/, bugfix/, hotfix/）
  • 名称简洁且具有意义

命令： gtr branch

4. Git 日志分析与项目洞察

获取基于 AI 的项目分析报告：

  • 贡献者活动模式
  • 各模块代码变更频率
  • 发布历史摘要
  • 技术债务指标

命令： gtr chat，然后提出关于项目洞察的问题

安装方法

Gitrama 通过 PyPI 发布：

pip install gitrama

验证安装是否成功：

gtr version

配置说明

无需配置 API 密钥或任何参数。Gitrama 默认连接 api.gitrama.ai 进行所有 AI 处理。

可选配置通过以下命令进行：

gtr config

使用示例

当用户询问 Git 历史或项目上下文时，运行对应的 Gitrama 命令：

# 启动交互式对话，探索仓库
gtr chat

# 为暂存的更改生成提交信息
gtr commit

# 根据任务描述生成分支名
gtr branch "add user authentication with OAuth"

# 快捷别名
gtr c   # commit 的快捷方式
gtr b   # branch 的快捷方式
gtr ch  # chat 的快捷方式

数据处理流程

本地 CLI (gtr) → 本地收集 Git 上下文 → POST 至 api.gitrama.ai → 返回 AI 分析结果
  • Git 上下文（提交记录、差异、分支信息）通过本地 Git 子进程调用收集
  • 上下文数据发送至 api.gitrama.ai 进行 AI 处理
  • 用户设备上不存储任何 API 密钥
  • 敏感逻辑和智能分析均在服务端完成，本地不运行完整模型

重要提示

  • Gitrama 必须在 Git 仓库内部运行
  • AskGIT 维护最多 40 条消息的多轮对话历史，支持上下文延续
  • 工具会自动收集仓库上下文，无需手动配置
  • 发送至 api.gitrama.ai 的仓库数据仅用于生成回复，不会被长期存储

错误处理

若安装后无法找到 gtr 命令：

# 确保 pip 脚本路径已加入系统 PATH
python3 -m gitrama --version

若出现连接错误：

# 检查 api.gitrama.ai 是否可达
curl -s https://api.gitrama.ai/health

相关链接

  • 官方网站：https://gitrama.ai
  • PyPI 页面：https://pypi.org/project/gitrama/
A
@ahmaxdev

已收录 1 个 Skill

相关推荐