forked from Gitlink/gitlink-cli
chore: 清理多余的场景文档目录
CI / test (push) Has been cancelled
Details
CI / test (push) Has been cancelled
Details
- 删除 sub-task3-scenario-a/b（架构图已在 SKILL.md 中） - 删除 sub-task4-module-c/d（报告模板由脚本自动生成） Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
parent
393a090c0e
commit
c0c7580a7e
|
|
@ -1,87 +0,0 @@
|
|||
# 社区运营自动化 — 架构图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph Trigger["触发层"]
|
||||
T1[新 Issue 创建]
|
||||
T2[定时触发（每周）]
|
||||
T3[版本发布需求]
|
||||
end
|
||||
|
||||
subgraph Phase1["Phase 1: Issue 自动分拣"]
|
||||
P1A["issue +list --state open"]
|
||||
P1B["issue +view（逐条详情）"]
|
||||
P1C["关键词权重分析<br/>(AI 驱动)"]
|
||||
P1D["label +list（获取标签）"]
|
||||
P1E["issue +update（打标签）"]
|
||||
P1F["issue +comment（引导评论）"]
|
||||
|
||||
P1A --> P1B --> P1C --> P1D --> P1E --> P1F
|
||||
end
|
||||
|
||||
subgraph Phase2["Phase 2: 社区周报生成"]
|
||||
P2A["issue +list（Issue 统计）"]
|
||||
P2B["pr +list（PR 统计）"]
|
||||
P2C["commit +list（贡献数据）"]
|
||||
P2D["milestone +list（里程碑）"]
|
||||
P2E["AI 健康度评分计算"]
|
||||
P2F["生成 Markdown 周报"]
|
||||
|
||||
P2A --> P2E
|
||||
P2B --> P2E
|
||||
P2C --> P2E
|
||||
P2D --> P2E
|
||||
P2E --> P2F
|
||||
end
|
||||
|
||||
subgraph Phase3["Phase 3: 自动 Release Notes"]
|
||||
P3A["release +list（获取最新 tag）"]
|
||||
P3B["git log tag..HEAD（提交历史）"]
|
||||
P3C["Conventional Commit 分类<br/>(AI 分析)"]
|
||||
P3D["语义化版本推荐"]
|
||||
P3E["生成结构化 Release Notes"]
|
||||
P3F["release +create（创建发布）"]
|
||||
|
||||
P3A --> P3B --> P3C --> P3D --> P3E --> P3F
|
||||
end
|
||||
|
||||
subgraph Output["输出层"]
|
||||
O1["Issue 分类结果<br/>(_output/issues-*.json)"]
|
||||
O2["健康度周报<br/>(_output/weekly-health-report.md)"]
|
||||
O3["Release Notes<br/>(_output/release-notes-*.md)"]
|
||||
end
|
||||
|
||||
T1 --> Phase1
|
||||
T2 --> Phase2
|
||||
T3 --> Phase3
|
||||
|
||||
Phase1 --> Output
|
||||
Phase2 --> Output
|
||||
Phase3 --> Output
|
||||
|
||||
classDef trigger fill:#ffcc80,stroke:#e65100
|
||||
classDef phase fill:#bbdefb,stroke:#1565c0
|
||||
classDef output fill:#c8e6c9,stroke:#2e7d32
|
||||
|
||||
class T1,T2,T3 trigger
|
||||
class Phase1,Phase2,Phase3 phase
|
||||
class O1,O2,O3 output
|
||||
```
|
||||
|
||||
## 数据流说明
|
||||
|
||||
| 阶段 | 输入 | 处理 | 输出 |
|
||||
|------|------|------|------|
|
||||
| Phase 1 | 未分类 Issue 列表 | AI 关键词权重评分 | 已分类 Issue + 引导评论 |
|
||||
| Phase 2 | Issue/PR/Commit/Milestone 原始数据 | 健康度评分公式 | Markdown 周报 |
|
||||
| Phase 3 | Release 列表 + git 提交历史 | Conventional Commit 分类 | Release Notes + 版本发布 |
|
||||
|
||||
## 命令依赖图
|
||||
|
||||
```
|
||||
issue +list → issue +view → issue +update / issue +comment
|
||||
↑ ↑ ↓
|
||||
label +list milestone +list commit +list → pr +list
|
||||
↑ ↑ ↑
|
||||
release +list ci +builds collaborator +list
|
||||
```
|
||||
|
|
@ -1,101 +0,0 @@
|
|||
# 代码质量看门人 — 架构图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph Trigger["触发层"]
|
||||
T1[新 PR 提交]
|
||||
T2[PR 代码更新]
|
||||
end
|
||||
|
||||
subgraph Phase1["Phase 1: PR 采集"]
|
||||
P1A["pr +list --state open"]
|
||||
P1B["过滤 pull_request_status=0"]
|
||||
P1C["排序（按创建时间）"]
|
||||
|
||||
P1A --> P1B --> P1C
|
||||
end
|
||||
|
||||
subgraph Phase2["Phase 2: 深度审查"]
|
||||
P2A["pr +view（PR 详情）"]
|
||||
P2B["pr +files（变更文件）"]
|
||||
P2C["pr +versions（版本历史）"]
|
||||
P2D["pr +version-diff（代码 diff）"]
|
||||
P2E["pr +reviews（已有评审）"]
|
||||
P2F["AI 代码审查评分"]
|
||||
|
||||
P2A --> P2F
|
||||
P2B --> P2F
|
||||
P2C --> P2D --> P2F
|
||||
P2E --> P2F
|
||||
end
|
||||
|
||||
subgraph Phase3["Phase 3: CI 状态检查"]
|
||||
P3A["ci +builds（构建列表）"]
|
||||
P3B["ci +runs（运行记录）"]
|
||||
P3C["AI 判定 CI 状态"]
|
||||
|
||||
P3A --> P3C
|
||||
P3B --> P3C
|
||||
end
|
||||
|
||||
subgraph Decision["门禁评分引擎"]
|
||||
D1["CodeReview 评分 × 40%"]
|
||||
D2["CI 状态 × 30%"]
|
||||
D3["设计一致性 × 30%"]
|
||||
D4{"总分 ≥ 70 且 CI 通过?"}
|
||||
D5["✅ 自动合并"]
|
||||
D6["❌ 阻塞 + 修改建议"]
|
||||
|
||||
D1 --> D4
|
||||
D2 --> D4
|
||||
D3 --> D4
|
||||
D4 -->|是| D5
|
||||
D4 -->|否| D6
|
||||
end
|
||||
|
||||
T1 --> Phase1
|
||||
T2 --> Phase1
|
||||
Phase1 --> Phase2
|
||||
Phase2 --> Decision
|
||||
Phase3 --> Decision
|
||||
|
||||
classDef trigger fill:#ffcc80,stroke:#e65100
|
||||
classDef phase fill:#bbdefb,stroke:#1565c0
|
||||
classDef decision fill:#f8bbd0,stroke:#c62828
|
||||
|
||||
class T1,T2 trigger
|
||||
class Phase1,Phase2,Phase3 phase
|
||||
class Decision,Phase1,Phase2,Phase3 phase
|
||||
class D1,D2,D3,D4,D5,D6 decision
|
||||
```
|
||||
|
||||
## 评分模型
|
||||
|
||||
```
|
||||
质量总分 = CodeReview 评分 × 40% + CI 状态 × 30% + 设计一致性 × 30%
|
||||
|
||||
CodeReview 评分（0-100）：
|
||||
- 起始 100 分
|
||||
- 每个 Critical: -20 分
|
||||
- 每个 Warning: -10 分
|
||||
- 每个 Suggestion: -3 分
|
||||
|
||||
CI 状态（0 或 100）：
|
||||
- 全部通过: 100
|
||||
- 有失败: 0
|
||||
|
||||
设计一致性（0-100）：
|
||||
- AI 评估 PR 描述与变更的匹配度
|
||||
|
||||
门槛：≥ 70 分 且 CI 通过 → 自动合并
|
||||
```
|
||||
|
||||
## 命令链
|
||||
|
||||
```
|
||||
pr +list → pr +view → pr +files → pr +versions → pr +version-diff → pr +reviews
|
||||
↑ ↓
|
||||
ci +builds pr +review
|
||||
↑ ↓
|
||||
ci +runs pr +merge
|
||||
```
|
||||
|
|
@ -1,75 +0,0 @@
|
|||
# 科研项目洞悉 — 架构图
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
subgraph DataCollection["数据采集层"]
|
||||
D1["repo +info<br/>仓库基本信息"]
|
||||
D2["repo +topics<br/>研究主题"]
|
||||
D3["repo +languages<br/>技术栈"]
|
||||
D4["commit +list<br/>提交历史"]
|
||||
D5["issue +list<br/>Issue 统计"]
|
||||
D6["pr +list<br/>PR 统计"]
|
||||
D7["collaborator +list<br/>团队结构"]
|
||||
end
|
||||
|
||||
subgraph AIAnalysis["AI 分析层"]
|
||||
A1["成熟度评估<br/>年龄/Star/Fork/更新"]
|
||||
A2["文档质量<br/>README/License/CI"]
|
||||
A3["贡献模式<br/>人数/频率/新贡献者"]
|
||||
A4["社区健康度<br/>关闭率/合并率/响应"]
|
||||
end
|
||||
|
||||
subgraph Scoring["评分引擎"]
|
||||
S1["成熟度 × 25%"]
|
||||
S2["文档 × 20%"]
|
||||
S3["贡献 × 30%"]
|
||||
S4["社区 × 25%"]
|
||||
S5["综合评分<br/>(1-10)"]
|
||||
end
|
||||
|
||||
subgraph Output["输出层"]
|
||||
O1["项目画像"]
|
||||
O2["维度评分"]
|
||||
O3["改进建议"]
|
||||
O4["可复现性评估"]
|
||||
end
|
||||
|
||||
D1 --> A1
|
||||
D2 --> A1
|
||||
D3 --> A2
|
||||
D4 --> A3
|
||||
D5 --> A4
|
||||
D6 --> A4
|
||||
D7 --> A3
|
||||
|
||||
A1 --> S1
|
||||
A2 --> S2
|
||||
A3 --> S3
|
||||
A4 --> S4
|
||||
|
||||
S1 --> S5
|
||||
S2 --> S5
|
||||
S3 --> S5
|
||||
S4 --> S5
|
||||
|
||||
S5 --> Output
|
||||
|
||||
classDef collection fill:#e3f2fd,stroke:#1565c0
|
||||
classDef analysis fill:#f3e5f5,stroke:#7b1fa2
|
||||
classDef score fill:#fff3e0,stroke:#e65100
|
||||
classDef output fill:#e8f5e9,stroke:#2e7d32
|
||||
|
||||
class D1,D2,D3,D4,D5,D6,D7 collection
|
||||
class A1,A2,A3,A4 analysis
|
||||
class S1,S2,S3,S4,S5 score
|
||||
class O1,O2,O3,O4 output
|
||||
```
|
||||
|
||||
## 评分维度与权重
|
||||
|
||||
| 维度 | 子指标 | 权重 |
|
||||
|------|--------|------|
|
||||
| **成熟度** | 项目年龄(25%)、Star(25%)、Fork(20%)、最近更新(30%) | 25% |
|
||||
| **文档质量** | README(3)、License(2)、Contributing(1)、CI(1) | 20% |
|
||||
| **贡献模式** | 贡献者数(30%)、提交频率(30%)、新贡献者(20%)、分布均匀度(20%) | 30% |
|
||||
| **社区健康度** | Issue 关闭率(30%)、响应时间(25%)、PR 合并率(25%)、合并时间(20%) | 25% |
|
||||
|
|
@ -1,128 +0,0 @@
|
|||
# 科研项目洞察报告 — 模板与使用说明
|
||||
|
||||
## 报告目的
|
||||
|
||||
本报告是 `gitlink-research-insight` Skill 的输出产物，用于对 GitLink 平台上的科研类仓库进行多维度分析，帮助科研工作者快速了解项目质量、成熟度和协作健康度。
|
||||
|
||||
---
|
||||
|
||||
## 使用方式
|
||||
|
||||
```bash
|
||||
# 针对特定仓库生成洞察报告
|
||||
bash skills/gitlink-research-insight/scripts/research-insight-full.sh <owner> <repo>
|
||||
|
||||
# 报告将输出到:
|
||||
# skills/gitlink-research-insight/scripts/_output/research-insight-report.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 报告模板
|
||||
|
||||
```markdown
|
||||
# 🔬 科研项目洞察报告 — {owner}/{repo}
|
||||
|
||||
**分析日期：** {date}
|
||||
**综合评分：** {score}/10 {emoji}
|
||||
|
||||
## 一、项目画像
|
||||
| 维度 | 数据 |
|
||||
|------|------|
|
||||
| 项目名称 | {name} |
|
||||
| 描述 | {description} |
|
||||
| 创建时间 | {created_at}（距今 {age}） |
|
||||
| Star / Fork | {stars} / {forks} |
|
||||
| 主要语言 | {languages} |
|
||||
| 研究主题 | {topics} |
|
||||
| 默认分支 | {default_branch} |
|
||||
|
||||
## 二、项目成熟度（{score}/10）
|
||||
|
||||
**评分因子：**
|
||||
- 项目年龄：{age_detail}
|
||||
- 社区影响力：{influence_detail}（Star: {stars}, Fork: {forks}）
|
||||
- 维护活跃度：{activity_detail}（最近更新: {last_update}）
|
||||
|
||||
**分析：** {analysis_text}
|
||||
|
||||
## 三、文档质量（{score}/10）
|
||||
|
||||
| 检查项 | 状态 | 说明 |
|
||||
|--------|------|------|
|
||||
| README | {status} | 项目核心文档 |
|
||||
| LICENSE | {status} | 开源许可证 |
|
||||
| CONTRIBUTING | {status} | 贡献指南 |
|
||||
| CI 配置 | {status} | 持续集成 |
|
||||
|
||||
**改进建议：** {suggestions}
|
||||
|
||||
## 四、贡献模式（{score}/10）
|
||||
|
||||
| 指标 | 数据 | 评分 |
|
||||
|------|------|------|
|
||||
| 贡献者总数 | {count} | {score} |
|
||||
| 提交频率 | {frequency} | {score} |
|
||||
| 新贡献者比例 | {ratio} | {score} |
|
||||
| 分布均匀度 | {distribution} | {score} |
|
||||
|
||||
**分析：** {analysis_text}
|
||||
|
||||
## 五、社区健康度（{score}/10）
|
||||
|
||||
| 指标 | 数据 | 评分 |
|
||||
|------|------|------|
|
||||
| Issue 总数 | {total}（打开 {open} / 关闭 {closed}） | — |
|
||||
| 关闭率 | {close_rate}% | {score} |
|
||||
| 平均响应时间 | {response_time} 天 | {score} |
|
||||
| PR 总数 | {pr_total}（合并 {merged} / 打开 {pr_open}） | — |
|
||||
| 合并率 | {merge_rate}% | {score} |
|
||||
| 平均合并时间 | {merge_time} 天 | {score} |
|
||||
|
||||
**分析：** {analysis_text}
|
||||
|
||||
## 六、可复现性评估
|
||||
|
||||
| 检查项 | 状态 | 说明 |
|
||||
|--------|------|------|
|
||||
| 开源许可证 | {status} | 用于判断是否可自由使用 |
|
||||
| 依赖文档化 | {status} | 是否有依赖声明文件 |
|
||||
| 运行说明 | {status} | 是否有环境搭建指南 |
|
||||
| 测试覆盖 | {status} | 是否有自动化测试 |
|
||||
|
||||
## 七、改进建议
|
||||
|
||||
1. **{priority} 优先级** — {suggestion_1}
|
||||
2. **{priority} 优先级** — {suggestion_2}
|
||||
3. **{priority} 优先级** — {suggestion_3}
|
||||
|
||||
---
|
||||
|
||||
*数据来源：gitlink-cli（repo +info, commit +list, issue +list, pr +list, collaborator +list）*
|
||||
*分析引擎：AI Agent | 生成时间：{datetime}*
|
||||
*注意：部分数据依赖仓库活跃度，不活跃仓库的某些维度可能评分较低*
|
||||
```
|
||||
|
||||
## 评分标准
|
||||
|
||||
| 综合得分 | 等级 | 说明 |
|
||||
|----------|------|------|
|
||||
| 9-10 | 🟢 优秀 | 文档完善、社区活跃、维护规范，适合作为参考项目 |
|
||||
| 7-8 | 🟢 良好 | 各方面表现不错，少量方面可改进 |
|
||||
| 5-6 | 🟡 一般 | 功能可用，但在文档或社区方面需要加强 |
|
||||
| 3-4 | 🔴 堪忧 | 缺少关键文档或社区不活跃，使用需谨慎 |
|
||||
| 0-2 | 🔴 危险 | 基本无人维护，不建议依赖 |
|
||||
|
||||
---
|
||||
|
||||
## 示例输出片段
|
||||
|
||||
```yaml
|
||||
综合评分：7.5/10 🟢 良好
|
||||
|
||||
## 关键发现
|
||||
- 项目有完整的 README 和 API 文档 ✅
|
||||
- 每周有 3-4 次提交，维护活跃 ✅
|
||||
- 缺少 good-first-issue，新贡献者入门门槛高 ⚠️
|
||||
- 建议补充 CONTRIBUTING.md 和 CI 配置
|
||||
```
|
||||
|
|
@ -1,100 +0,0 @@
|
|||
# 科研热点追踪与知识图谱 — 架构图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph Input["输入层"]
|
||||
I1["领域关键词 1"]
|
||||
I2["领域关键词 2"]
|
||||
I3["领域关键词 3"]
|
||||
I4["领域关键词 N"]
|
||||
end
|
||||
|
||||
subgraph SearchLayer["搜索层"]
|
||||
S1["search +repos --keyword K1"]
|
||||
S2["search +repos --keyword K2"]
|
||||
S3["search +repos --keyword K3"]
|
||||
S4["search +repos --keyword KN"]
|
||||
S5[("结果去重合并<br/>all-search-results.json")]
|
||||
|
||||
I1 --> S1 --> S5
|
||||
I2 --> S2 --> S5
|
||||
I3 --> S3 --> S5
|
||||
I4 --> S4 --> S5
|
||||
end
|
||||
|
||||
subgraph EnrichLayer["丰富层"]
|
||||
E1["repo +info（仓库详情）"]
|
||||
E2["repo +topics（研究主题）"]
|
||||
E3["repo +languages（技术栈）"]
|
||||
E4["repo +contributors（贡献者）"]
|
||||
|
||||
S5 --> E1
|
||||
S5 --> E2
|
||||
S5 --> E3
|
||||
S5 --> E4
|
||||
end
|
||||
|
||||
subgraph AILayer["AI 分析层"]
|
||||
A1["实体提取"]
|
||||
A2["关系识别"]
|
||||
A3["主题聚类"]
|
||||
A4["趋势分析"]
|
||||
|
||||
A1 --> A2
|
||||
A2 --> A3
|
||||
A3 --> A4
|
||||
end
|
||||
|
||||
subgraph OutputLayer["输出层"]
|
||||
O1["Mermaid 知识图谱<br/>(项目-主题-技术-组织)"]
|
||||
O2["热点趋势报告<br/>(主题排行+技术分布)"]
|
||||
O3["推荐关注项目"]
|
||||
O4["交叉领域发现"]
|
||||
end
|
||||
|
||||
E1 --> A1
|
||||
E2 --> A1
|
||||
E3 --> A1
|
||||
E4 --> A1
|
||||
|
||||
A4 --> OutputLayer
|
||||
|
||||
classDef input fill:#ffcc80,stroke:#e65100
|
||||
classDef search fill:#bbdefb,stroke:#1565c0
|
||||
classDef enrich fill:#c8e6c9,stroke:#2e7d32
|
||||
classDef ai fill:#f3e5f5,stroke:#7b1fa2
|
||||
classDef output fill:#ffe0b2,stroke:#bf360c
|
||||
|
||||
class I1,I2,I3,I4 input
|
||||
class S1,S2,S3,S4,S5 search
|
||||
class E1,E2,E3,E4 enrich
|
||||
class A1,A2,A3,A4 ai
|
||||
class O1,O2,O3,O4 output
|
||||
```
|
||||
|
||||
## 知识图谱实体关系
|
||||
|
||||
```
|
||||
实体类型：
|
||||
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
||||
│ 项目 │ │ 主题 │ │ 技术栈 │ │ 组织 │
|
||||
│ (Project)│ │ (Topic) │ │ (Tech) │ │ (Org) │
|
||||
└────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘
|
||||
│ │ │ │
|
||||
├── topic ───────┤ │ │
|
||||
├── uses ────────────────────────┤ │
|
||||
├── belongs_to ──────────────────────────────────┤
|
||||
└── related_to ─── 另一个项目 ────┘
|
||||
```
|
||||
|
||||
## 数据流
|
||||
|
||||
```
|
||||
关键词(s) → search +repos → 去重合并 → repo +info/topics/languages
|
||||
↓
|
||||
AI 实体提取
|
||||
↓
|
||||
┌───────────────┴───────────────┐
|
||||
↓ ↓
|
||||
知识图谱 (Mermaid) 热点趋势报告
|
||||
```
|
||||
|
|
@ -1,120 +0,0 @@
|
|||
# 科研热点趋势报告 — 模板与使用说明
|
||||
|
||||
## 报告目的
|
||||
|
||||
本报告是 `gitlink-research-hotspot` Skill 的输出产物，通过对指定科研领域进行多关键词搜索和分析，揭示当前 GitLink 平台上的研究热点分布、技术栈偏好和组织活跃度。
|
||||
|
||||
---
|
||||
|
||||
## 使用方式
|
||||
|
||||
```bash
|
||||
# 针对特定领域生成热点趋势报告
|
||||
bash skills/gitlink-research-hotspot/scripts/hotspot-tracker-full.sh <keyword1> [keyword2] ...
|
||||
|
||||
# 示例：AI 领域
|
||||
bash hotspot-tracker-full.sh "machine learning" "deep learning" "自然语言处理" "computer vision"
|
||||
|
||||
# 报告将输出到:
|
||||
# skills/gitlink-research-hotspot/scripts/_output/hotspot-trend-report-<domain>.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 报告模板
|
||||
|
||||
```markdown
|
||||
# 📈 科研热点趋势报告 — {domain}
|
||||
|
||||
**分析日期：** {date}
|
||||
**搜索关键词：** {keywords}
|
||||
|
||||
## 一、搜索概览
|
||||
|
||||
| 维度 | 数据 |
|
||||
|------|------|
|
||||
| 搜索关键词数 | {keyword_count} |
|
||||
| 发现仓库总数 | {total_repos} |
|
||||
| 分析时间范围 | {date_range} |
|
||||
|
||||
## 二、热门主题排行
|
||||
|
||||
| 排名 | 主题/标签 | 出现次数 | 覆盖仓库 | 趋势 |
|
||||
|------|-----------|----------|----------|------|
|
||||
| 1 | {topic_1} | {count_1} | {pct_1}% | 📈 上升 |
|
||||
| 2 | {topic_2} | {count_2} | {pct_2}% | 📈 上升 |
|
||||
| 3 | {topic_3} | {count_3} | {pct_3}% | ➡️ 稳定 |
|
||||
| 4 | {topic_4} | {count_4} | {pct_4}% | ➡️ 稳定 |
|
||||
| 5 | {topic_5} | {count_5} | {pct_5}% | 📉 下降 |
|
||||
|
||||
## 三、技术栈分布
|
||||
|
||||
| 排名 | 编程语言 | 仓库数 | 占比 |
|
||||
|------|----------|--------|------|
|
||||
| 1 | {lang_1} | {count} | {pct}% |
|
||||
| 2 | {lang_2} | {count} | {pct}% |
|
||||
| 3 | {lang_3} | {count} | {pct}% |
|
||||
|
||||
## 四、活跃组织排行
|
||||
|
||||
| 排名 | 组织/用户 | 仓库数 | 主要领域 |
|
||||
|------|-----------|--------|----------|
|
||||
| 1 | {org_1} | {count} | {domain} |
|
||||
| 2 | {org_2} | {count} | {domain} |
|
||||
| 3 | {org_3} | {count} | {domain} |
|
||||
|
||||
## 五、交叉领域发现
|
||||
|
||||
以下主题标签经常同时出现在同一仓库中，可能代表有潜力的交叉研究方向：
|
||||
|
||||
| 交叉组合 | 共现次数 | 说明 |
|
||||
|----------|----------|------|
|
||||
| {topic_A} + {topic_B} | {count} | {insight} |
|
||||
| {topic_C} + {topic_D} | {count} | {insight} |
|
||||
|
||||
## 六、推荐关注项目
|
||||
|
||||
以下项目在该领域具有较高参考价值：
|
||||
|
||||
1. **{owner_1}/{repo_1}** ⭐ {stars}
|
||||
- {description}
|
||||
- 推荐理由：{reason}
|
||||
|
||||
2. **{owner_2}/{repo_2}** ⭐ {stars}
|
||||
- {description}
|
||||
- 推荐理由：{reason}
|
||||
|
||||
3. **{owner_3}/{repo_3}** ⭐ {stars}
|
||||
- {description}
|
||||
- 推荐理由：{reason}
|
||||
|
||||
## 七、趋势洞察
|
||||
|
||||
{insight_text}
|
||||
|
||||
---
|
||||
|
||||
*数据来源：gitlink-cli search +repos / repo +info*
|
||||
*分析引擎：AI Agent | 生成时间：{datetime}*
|
||||
*建议每月重复执行以跟踪趋势变化*
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 示例输出片段
|
||||
|
||||
```markdown
|
||||
## 热门主题排行
|
||||
| 排名 | 主题 | 出现次数 | 趋势 |
|
||||
|------|------|----------|------|
|
||||
| 1 | Natural Language Processing | 5 | 📈 |
|
||||
| 2 | Deep Learning | 4 | 📈 |
|
||||
| 3 | Machine Learning | 3 | ➡️ |
|
||||
|
||||
## 技术栈分布
|
||||
| 语言 | 占比 |
|
||||
|------|------|
|
||||
| Python | 60% |
|
||||
| Jupyter Notebook | 25% |
|
||||
| Go | 15% |
|
||||
```
|
||||
|
|
@ -1,123 +0,0 @@
|
|||
# 科研知识图谱 — 模板与说明
|
||||
|
||||
## 用途
|
||||
|
||||
知识图谱是 `gitlink-research-hotspot` Skill 的输出之一，以 Mermaid.js 流程图的形式展示科研领域内的项目、主题、技术栈和组织之间的关联关系。
|
||||
|
||||
---
|
||||
|
||||
## 使用方式
|
||||
|
||||
```bash
|
||||
# 知识图谱由 hotspot-tracker-full.sh 自动生成
|
||||
# 输出位置:
|
||||
# skills/gitlink-research-hotspot/scripts/_output/knowledge-graph-<domain>.md
|
||||
```
|
||||
|
||||
## 图谱结构
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
%% ========== 实体定义 ==========
|
||||
|
||||
subgraph Projects["🔬 研究项目"]
|
||||
P1["项目名称<br/>(owner/repo)"]
|
||||
P2["项目名称<br/>(owner/repo)"]
|
||||
P3["项目名称<br/>(owner/repo)"]
|
||||
end
|
||||
|
||||
subgraph Topics["📚 研究主题"]
|
||||
T1["主题标签 A"]
|
||||
T2["主题标签 B"]
|
||||
T3["主题标签 C"]
|
||||
end
|
||||
|
||||
subgraph Techs["💻 技术栈"]
|
||||
S1["编程语言/框架 X"]
|
||||
S2["编程语言/框架 Y"]
|
||||
S3["编程语言/框架 Z"]
|
||||
end
|
||||
|
||||
subgraph Orgs["🏛️ 组织机构"]
|
||||
O1["组织/用户 1"]
|
||||
O2["组织/用户 2"]
|
||||
end
|
||||
|
||||
%% ========== 关系定义 ==========
|
||||
|
||||
P1 -->|topic| T1
|
||||
P1 -->|topic| T2
|
||||
P1 -->|uses| S1
|
||||
P1 -->|uses| S2
|
||||
P1 -->|belongs_to| O1
|
||||
|
||||
P2 -->|topic| T2
|
||||
P2 -->|topic| T3
|
||||
P2 -->|uses| S2
|
||||
P2 -->|belongs_to| O1
|
||||
|
||||
P3 -->|topic| T1
|
||||
P3 -->|uses| S3
|
||||
P3 -->|belongs_to| O2
|
||||
|
||||
P2 -.->|related_to| P1
|
||||
|
||||
%% ========== 样式定义 ==========
|
||||
|
||||
classDef project fill:#e1f5fe,stroke:#01579b,color:#01579b
|
||||
classDef topic fill:#f3e5f5,stroke:#7b1fa2,color:#7b1fa2
|
||||
classDef tech fill:#e8f5e9,stroke:#2e7d32,color:#2e7d32
|
||||
classDef org fill:#fff3e0,stroke:#e65100,color:#e65100
|
||||
|
||||
class P1,P2,P3 project
|
||||
class T1,T2,T3 topic
|
||||
class S1,S2,S3 tech
|
||||
class O1,O2 org
|
||||
```
|
||||
|
||||
## 实体与关系说明
|
||||
|
||||
### 实体类型
|
||||
|
||||
| 图标 | 类型 | 说明 | 数据来源 |
|
||||
|------|------|------|----------|
|
||||
| 🔬 | 项目 (Project) | GitLink 上的仓库 | `search +repos`, `repo +info` |
|
||||
| 📚 | 主题 (Topic) | 仓库的研究主题标签 | `repo +topics` |
|
||||
| 💻 | 技术栈 (Tech) | 编程语言和框架 | `repo +languages` |
|
||||
| 🏛️ | 组织 (Org) | 所属组织或个人 | `repo +info → owner` |
|
||||
|
||||
### 关系类型
|
||||
|
||||
| 关系 | 箭头 | 说明 |
|
||||
|------|------|------|
|
||||
| `topic` | `项目 → 主题` | 项目涉及的研究主题 |
|
||||
| `uses` | `项目 → 技术栈` | 项目使用的编程语言/框架 |
|
||||
| `belongs_to` | `项目 → 组织` | 项目所属的组织/用户 |
|
||||
| `related_to` | `项目 → 项目` | 项目之间的关联关系（共现主题标签） |
|
||||
|
||||
## 自动生成流程
|
||||
|
||||
```
|
||||
搜索结果 JSON 文件
|
||||
↓
|
||||
AI Agent 提取实体（项目/主题/技术栈/组织）
|
||||
↓
|
||||
AI Agent 识别关系（topic/uses/belongs_to/related_to）
|
||||
↓
|
||||
生成 Mermaid.js 语法
|
||||
↓
|
||||
写入 knowledge-graph-<domain>.md 文件
|
||||
↓
|
||||
用户可在支持 Mermaid 的 Markdown 渲染器中查看
|
||||
```
|
||||
|
||||
## 解读方法
|
||||
|
||||
1. **密集连接的节点**代表该领域的核心项目或主题
|
||||
2. **跨领域连接的节点**代表交叉研究方向
|
||||
3. **孤立节点**可能代表新兴但尚未被广泛关联的方向
|
||||
4. **组织归属**可帮助发现特定机构的研究重点
|
||||
|
||||
---
|
||||
|
||||
*生成工具：gitlink-research-hotspot Skill | Mermaid.js 版本：10.x+*
|
||||
Loading…
Reference in New Issue