---
name: github-deep-research
description: GitHub 仓库深度研究 — 多轮研究结合 GitHub API、Web搜索和内容抓取，产出包含执行摘要、时间线、指标分析和架构图的全面分析报告。
triggers:
  - "分析仓库"
  - "研究这个项目"
  - "GitHub分析"
  - "开源项目分析"
  - "仓库调研"
  - "项目深度研究"
tools:
  - web_fetch
  - bash
  - read
  - write
---

# GitHub 深度研究技能

多轮研究结合 GitHub API、Web 搜索和内容抓取，产出全面的 Markdown 分析报告。

## 研究工作流

### Round 1: GitHub API 基础数据

通过 GitHub API 获取核心指标：

```bash
# 仓库基本信息
curl -s "https://api.github.com/repos/{owner}/{repo}"

# Star 历史（需 token）
# 贡献者
curl -s "https://api.github.com/repos/{owner}/{repo}/contributors?per_page=30"

# 最近提交
curl -s "https://api.github.com/repos/{owner}/{repo}/commits?per_page=30"

# Issues 和 PR 统计
curl -s "https://api.github.com/repos/{owner}/{repo}/issues?state=all&per_page=30"
```

提取指标：
- Star/Fork/Watch 数量及趋势
- 贡献者数量和活跃度
- 提交频率和最近活动
- Issue 解决速度
- 语言分布
- License 类型

### Round 2: 发现与概览

通过 Web 搜索了解项目全貌：

```
搜索关键词:
- "{project} overview"
- "{project} architecture"
- "{project} 使用教程"
- "{project} vs alternatives"
```

### Round 3: 深度调查

针对关键问题深入研究：

```
搜索关键词:
- "{project} 性能测试"
- "{project} 生产环境"
- "{project} known issues"
- "{project} roadmap"
```

### Round 4: 深度分析

综合所有信息，产出最终报告。

## 报告模板

```markdown
# {项目名称} 深度研究报告

## 执行摘要
[3-5 句话概括项目定位、成熟度和建议]

## 1. 项目概览
- 定位与目标
- 核心功能
- 技术栈

## 2. 关键指标

| 指标 | 数值 | 说明 |
|------|------|------|
| Stars | XX | 增长趋势 |
| Forks | XX | 社区分支活跃度 |
| Contributors | XX | 核心贡献者数量 |
| Last Commit | XX | 项目活跃度 |
| License | XX | 开源许可 |

## 3. 架构分析
[目录结构、核心模块、依赖关系]

## 4. 社区与生态
[贡献者分析、Issue 处理效率、生态系统]

## 5. 发展时间线
[关键版本和里程碑的 Mermaid 时间线图]

## 6. 竞品对比
[与同类项目的功能/性能/生态对比表]

## 7. 风险与建议
[技术风险、社区风险、使用建议]
```

## Mermaid 图表

报告中可使用 Mermaid 语法嵌入：

**时间线图**:
```mermaid
timeline
    title 项目发展时间线
    2024-Q1 : v1.0 发布
    2024-Q2 : 获得 1000 Stars
    2024-Q3 : v2.0 架构重构
```

**架构图**:
```mermaid
graph TB
    A[核心模块] --> B[插件系统]
    A --> C[API层]
    B --> D[扩展1]
    B --> E[扩展2]
```

## 输出

1. 完整的 Markdown 分析报告
2. 关键指标汇总表
3. 架构图（Mermaid）
4. 发展时间线
5. 客观的风险评估和使用建议