---
name: gitlink-research-hotspot
version: 1.0.0
description: "科研热点追踪与知识图谱：按领域关键词搜索 GitLink 仓库，AI 提取研究主题、技术栈、团队结构，构建可视化的知识图谱与热点趋势报告。"
metadata:
  requires:
    bins: ["gitlink-cli", "jq"]
  cliHelp: "gitlink-cli search --help / gitlink-cli repo --help"
---

# gitlink-research-hotspot（科研热点追踪与知识图谱）

> **前置条件：** 先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md) 了解认证、全局参数和 API 注意事项。
>
> **CRITICAL — 所有 GitLink 操作必须使用 `gitlink-cli`。**

## 说明

本 Skill 面向科研工作者，通过 gitlink-cli 的搜索和数据获取能力，按科研领域关键词发现 GitLink 平台上的相关仓库，利用 AI 提取实体关系，构建可视化的知识图谱和热点趋势分析报告。

### 工作流程

```mermaid
flowchart LR
    A[领域关键词] --> B[多关键词搜索]
    B --> C[仓库数据丰富]
    C --> D[实体关系提取]
    D --> E[知识图谱可视化]
    D --> F[热点趋势报告]
    
    subgraph B[搜索层]
        B1[search +repos k1]
        B2[search +repos k2]
        B3[search +repos k3]
    end
    
    subgraph C[丰富层]
        C1[repo +info]
        C2[repo +topics]
        C3[repo +languages]
    end
    
    subgraph E[图谱]
        E1[项目节点]
        E2[主题节点]
        E3[技术节点]
        E4[组织节点]
    end
```

---

## 数据采集

### 多关键词搜索策略

对每个科研领域使用 3-5 个相关关键词进行搜索，确保覆盖全面：

```bash
# 示例：机器学习领域
gitlink-cli search +repos --keyword "machine learning" --format json
gitlink-cli search +repos --keyword "deep learning" --format json
gitlink-cli search +repos --keyword "自然语言处理" --format json
gitlink-cli search +repos --keyword "computer vision" --format json
```

### 仓库数据丰富

对搜索结果中的每个仓库，采集详细信息：

```bash
# 仓库详情
gitlink-cli repo +info --owner <owner> --repo <repo> --format json

# 主题标签
gitlink-cli repo +topics --owner <owner> --repo <repo> --format json

# 编程语言
gitlink-cli repo +languages --owner <owner> --repo <repo> --format json

# 贡献者
gitlink-cli repo +contributors --owner <owner> --repo <repo> --format json
```

---

## 实体关系提取

AI Agent 从采集的数据中提取以下实体：

### 实体类型

| 实体类型 | 提取来源 | 示例 |
|----------|----------|------|
| **项目** (Project) | repo +info → name/description | Pytorch, TensorFlow |
| **研究主题** (Topic) | repo +topics | NLP, Computer Vision |
| **技术栈** (Tech) | repo +languages | Python, C++, Go |
| **组织** (Organization) | repo +info → owner | GitLink, Apache |
| **贡献者** (Contributor) | contributors | user1, user2 |

### 关系类型

| 关系 | 说明 | 示例 |
|------|------|------|
| `uses` | 项目使用的技术 | Pytorch → uses → Python |
| `belongs_to` | 项目所属组织 | Pytorch → belongs_to → Apache |
| `related_to` | 项目间关联 | ProjectA → related_to → ProjectB |
| `contributes` | 贡献者参与项目 | user1 → contributes → Pytorch |

---

## 知识图谱（Mermaid.js）

```mermaid
flowchart LR
    subgraph Projects["🔬 研究项目"]
        P1[Project A]
        P2[Project B]
        P3[Project C]
    end
    
    subgraph Topics["📚 研究主题"]
        T1[NLP]
        T2[CV]
        T3[ML]
    end
    
    subgraph Techs["💻 技术栈"]
        S1[Python]
        S2[PyTorch]
        S3[TensorFlow]
    end
    
    subgraph Orgs["🏛️ 组织机构"]
        O1[University]
        O2[Company]
    end
    
    P1 -->|uses| S1
    P1 -->|uses| S2
    P1 -->|belongs_to| O1
    P2 -->|related_to| P1
    P2 -->|uses| S3
    P3 -->|topic| T1
    P1 -->|topic| T3
    
    classDef project fill:#e1f5fe,stroke:#01579b
    classDef topic fill:#f3e5f5,stroke:#7b1fa2
    classDef tech fill:#e8f5e9,stroke:#2e7d32
    classDef org fill:#fff3e0,stroke:#e65100
    
    class P1,P2,P3 project
    class T1,T2,T3 topic
    class S1,S2,S3 tech
    class O1,O2 org
```

---

## 热点趋势分析

### 分析维度

| 维度 | 分析方法 | 输出 |
|------|----------|------|
| 关键词频次 | 统计搜索结果的仓库出现频次 | 热门主题排行 |
| 技术栈分布 | 统计各编程语言/框架的使用率 | 技术栈雷达图 |
| 组织活跃度 | 统计各组织的仓库数量和活跃度 | 组织贡献排行 |
| 领域交叉 | 分析多主题标签的共现关系 | 交叉领域发现 |

### 趋势报告模板

```markdown
# 📈 科研热点趋势报告 — {domain}

**分析日期：** {date}
**搜索关键词：** {keywords}

## 热门主题排行
| 排名 | 主题 | 相关仓库数 | 趋势 |
|------|------|-----------|------|
| 1 | {topic1} | {count} | 📈/📉/➡️ |
| 2 | {topic2} | {count} | 📈/📉/➡️ |

## 技术栈分布
- Python: {percent}%
- JavaScript: {percent}%
- Go: {percent}%
- ...

## 活跃组织排行
| 排名 | 组织 | 仓库数 | 主要领域 |
|------|------|--------|----------|
| 1 | {org} | {count} | {domain} |

## 交叉领域发现
- {topic_A} + {topic_B}: {count} 个仓库同时涉及
- 潜在研究方向: {insight}

## 推荐关注项目
1. {repo} — {reason}
2. {repo} — {reason}
```

---

## 可复现脚本

| 脚本 | 功能 |
|------|------|
| `scripts/01-search-repos.sh` | 多关键词搜索，去重汇总 |
| `scripts/02-build-knowledge-graph.sh` | 构建 Mermaid 知识图谱 |
| `scripts/hotspot-tracker-full.sh` | 完整流程编排 |

---

## 注意事项

1. 关键词选择直接影响搜索结果质量，建议每个领域使用 3-5 个中英文关键词
2. GitLink 搜索可能分页，注意检查 `total_count` 确认是否覆盖全部结果
3. 知识图谱使用 Mermaid.js 语法，可在支持 Mermaid 的 Markdown 渲染器中直接显示
4. 热点趋势是快照分析而非实时追踪，如需趋势变化需定期重复执行
5. 科研类仓库的判别依赖仓库描述和主题标签，可能存在漏判
