GitLab Team Report

该 Skill 通过脚本读取 GitLab 数据，按一级/二级分类及成员、仓库维度汇总本周 MR 与 commit，生成 Markdown/HTML 周报、stats.json、图表与历史报告首页，并可选上传至飞书文档；分类结果可通过配置文件和分类规则文件调整。

wangzn

热度 51.20

最近更新 2026-05-11 17:34:12

分类：数据依赖：代码执行 / 读写文件 / 第三方 API应用场景：报告撰写 / 数据处理 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add gitlab-team-report

Metadata

name: gitlab-weekly-report
description: 生成 GitLab 团队周报，支持按产品功能分类 MR、按成员和仓库汇总贡献、输出 Markdown/HTML、生成图表和历史周报首页，并可选上传到飞书文档。用于用户提到“GitLab 周报”“团队周报”“统计本周 MR/commit”“按功能归类开发工作”“生成 HTML 周报”“上传周报到飞书”等场景。 Generate GitLab weekly team reports with MR categorization, contributor and repository summaries, Markdown/HTML output, charts, historical report index pages, and optional Feishu publishing. Use when users ask for “GitLab weekly report”, “team engineering summary”, “summarize merge requests and commits”, “group work by product area”, “generate an HTML report”, or “publish the report to Feishu”.

GitLab Weekly Report Generator

生成适合团队复盘、周会同步和对外汇报的 GitLab 周报。

执行流程

读取 config/config.json；如果不存在，先从 config/config.example.json 复制一份再填写。
运行 scripts/generate-report.sh 生成周报主文件。
如需图表，运行 scripts/generate-charts.py；如果环境缺少 matplotlib，接受 Mermaid 回退方案。
如需发布到飞书，使用 scripts/upload-to-feishu.sh 或 scripts/upload-to-feishu.js。
优先修改配置和分类规则，不要直接改业务脚本，除非需求本身变了。

主要能力

按 一级分类 → 二级分类 → MR 组织产品功能周报
按 人 → repo 汇总 MR、commit、贡献摘要
输出 weekly_report.md 与 weekly_report.html
生成 stats.json、图表和 reports/index.html
保持 Markdown 尽量兼容飞书文档
为 MR 和成员附上 GitLab 链接
支持“规则优先 + 启发式补全”的分类方式

关键文件

scripts/generate-report.sh：命令入口
scripts/generate-report.py：主逻辑
scripts/generate-charts.py：图表生成
scripts/upload-to-feishu.sh / scripts/upload-to-feishu.js：飞书上传
config/config.example.json：配置示例
config/classification.rules.example.json：分类规则示例
templates/report.template.md：报告模板

配置方式

优先使用以下文件：

config/config.json
config/classification.rules.json

如果规则文件不存在，就从对应的 *.example.json 复制后再修改。

优先调整顺序：

repo_rules：适合仓库名、路径、项目归属明显的场景
keyword_rules：适合 title / label / branch 关键词补充判断
default_category：兜底分类

基本用法

cd /path/to/gitlab-weekly-report

cp config/config.example.json config/config.json
cp config/classification.rules.example.json config/classification.rules.json

./scripts/generate-report.sh \
  -c config/config.json \
  -s 2026-03-14 \
  -e 2026-03-19

可选参数：

参数	说明
`-c, --config`	配置文件
`-s, --start-date`	开始日期
`-e, --end-date`	结束日期
`-o, --output`	输出目录
`--no-charts`	跳过图表生成

典型输出

reports/
├── index.html
├── latest -> 2026-03-14_to_2026-03-19/
└── 2026-03-14_to_2026-03-19/
    ├── weekly_report.md
    ├── weekly_report.html
    ├── stats.json
    └── charts/

依赖

必需：

python3
jq

注意事项

保持 SKILL.md 聚焦流程和决策，不要把大段样例配置塞进来。
优先通过配置和规则文件调整分类结果。
接受图表回退到 Mermaid 的情况，不要因为缺少 matplotlib 阻塞周报生成。
飞书上传依赖本地配置和权限；发布 skill 时不要分发真实 token 或私有配置文件。