GitLab Agent Profile

📊 自动化 GitLab 贡献统计与可视化

自动化维护 GitLab Agent 贡献统计与可视化图表,支持 MR 分类、贡献评分及静态资源更新

收藏
3.1k
安装
1.5k
版本
1.73.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

GitLab Agent Profile Skill 是一个面向自动化代理的运维工具,用于持续追踪并可视化展示代理与代码所有者(Owner)在 GitLab 仓库中的协作贡献。该技能通过 glab CLI 和 Python 脚本 update-profile-stats.py 实现以下功能:

1. 数据采集:自动扫描指定项目中的合并请求(MR)和直接提交,按作者身份(Owner/Agent)和审查状态分类统计
2. 贡献评分:基于 MR 类型标签(type::fix/type::feature)和大小标签(size::smallsize::xlarge)计算加权贡献分,直接提交按 0.2 分计

3. 可视化生成:输出静态 SVG 和 WebP 格式的 12 个月贡献柱状图,包含图例和精确数值标签

4. 审计追踪:生成 JSON 格式的原始数据证明文件,按日期降序排列

显著优点

  • 自动化程度高:支持定时任务(cron),15 分钟间隔自动执行
  • 分类精细:区分 Owner 自主工作、Agent 协作工作(Owner 审查)、Agent 自主工作三类 MR,以及 Owner 直接提交
  • 灵活配置:通过环境变量控制输出路径、项目范围、时间跨度、用户映射等
  • 规范友好:兼容 Conventional Commits 规范,支持标签缺失时的类型回退推断

潜在缺点与局限性

  • 依赖外部工具链:必须预装 glab CLI 和 Python3,且需有效的 GITLAB_TOKEN
  • 项目路径解析魔法:短名称自动拼接 ROOT_GROUP 的设计可能引发路径歧义
  • 评分规则硬编码:大小因子和类型过滤逻辑嵌入脚本,无法通过配置调整
  • 静态输出限制:仅生成静态图片,无交互式图表或实时 API 查询能力
  • 单实例假设:设计针对特定 GitLab 实例(xrow-public 为默认 root group),多实例迁移需手动调整

适合人群

  • 使用 GitLab 进行 AI 代理协作开发的团队
  • 需要量化展示人机协作贡献比例的技术管理者
  • 追求开源贡献可视化自动化的个人开发者

常规风险

  • Token 泄露风险:GITLAB_TOKEN 需具备 MR/Commit 读取权限,若配置不当可能导致仓库信息暴露
  • 误判风险:Commit 消息前缀过滤(skip:/chore:/docs:/revert)可能误排除有效贡献
  • 数据一致性:依赖 GitLab API 的实时性,统计窗口边缘的 MR 状态变化可能导致短期数据漂移

GitLab Agent Profile 内容

scripts文件夹
手动下载zip · 9.3 kB
profile_chart.pytext/plain
请选择文件