# GitHub团队健康度AI检测器
## 工作流概述
这是一个基于n8n的智能团队健康监测系统，通过分析GitHub仓库的开发活动数据，自动检测潜在的开发者倦怠风险和工作负载不平衡问题。
## 🎯 核心功能
### 数据收集与分析
– **定期监控**: 每周自动运行一次（可自定义频率）
– **多维度数据采集**:
– GitHub提交记录（commits）
– 拉取请求（Pull Requests）状态
– GitHub Actions工作流执行情况
– **智能模式识别**:
– 深夜提交（22:00-06:00）
– 周末工作提交
– 工作流失败率
– 开发者活动分布
### AI驱动的健康评估
– **Groq AI模型分析**: 使用GPT-OSS-120B模型进行专业团队健康评估
– **客观数据分析**: 基于证据的工作模式识别
– **健康评分系统**: 0-100分的团队健康度评分
– **风险识别**: 自动识别系统性风险和潜在倦怠信号
### 自动化报告与通知
– **GitHub Issues创建**: 自动生成团队健康报告问题
– **邮件通知**: 向指定邮箱发送详细健康报告
– **HTML格式报告**: 专业美观的可视化报告
## 🔧 技术架构
### 核心节点
– **Schedule Trigger**: 定时触发器，控制执行频率
– **HTTP Request**: GitHub API数据获取
– **Code Node**: 数据模式分析逻辑
– **AI Agent**: 智能健康评估代理
– **Groq Chat Model**: AI模型处理
– **GitHub Tool**: 问题创建与管理
– **Gmail Tool**: 邮件通知发送
### 数据处理流程
1. **配置设置**: 设置仓库信息、分析周期和通知邮箱
2. **数据收集**: 从GitHub API获取提交、PR、工作流数据
3. **模式分析**: 计算深夜提交率、周末工作率等指标
4. **AI评估**: 生成专业健康报告和风险评估
5. **报告分发**: 创建GitHub Issue并发送邮件通知
## 🛠️ 设置要求
### 必备集成
– **GitHub账户**: 用于访问仓库数据和创建Issue
– **Groq API**: 用于AI模型处理
– **Gmail账户**: 用于发送邮件通知
### 配置参数
– `repoowner`: GitHub仓库所有者
– `reponame`: 仓库名称
– `period`: 分析周期（默认7天）
– `emailreport`: 报告接收邮箱
## 📊 报告内容
生成的团队健康报告包含：
– 团队活动快照（提交数、PR数、工作流数）
– 开发者活动细分
– 健康评分和置信度
– 观察到的模式（深夜工作、周末工作等）
– 系统性风险识别
– 可操作建议和改进措施
## 🎯 应用场景
### 团队管理
– 开发团队健康度监控
– 工作负载平衡分析
– 倦怠风险早期预警
– 团队协作效率优化
### 项目管理
– 项目进度健康评估
– 开发资源分配优化
– 团队可持续性管理
## ⚡ 优势特点
– **自动化运行**: 无需人工干预，定期自动执行
– **客观评估**: 基于数据而非主观判断
– **早期预警**: 及时发现潜在问题
– **专业报告**: AI生成的详细分析报告
– **易于集成**: 标准n8n工作流，易于部署和维护
## 📝 使用建议
1. 根据团队规模调整分析频率
2. 设置合理的健康阈值
3. 结合其他团队指标综合评估
4. 定期审查和改进检测逻辑
这个工作流为技术团队提供了一个强大的自动化健康监测工具，帮助管理者及时发现和解决团队健康问题，提升整体开发效率和团队幸福感。
评论(0)