skill-github-project-analyzer

SKILL.md

---
name: github-project-analyzer
description: 深度分析GitHub项目，输出大白话版项目评估报告；当用户提供GitHub链接或要求分析GitHub项目时使用
---

# GitHub 项目深度分析技能

## 🎯 技能定位

想象你有个技术大牛朋友，你扔给他一个 GitHub 链接，他能帮你把这个项目扒得底朝天，然后用大白话告诉你：「这玩意儿是干啥的、值不值得学、有没有坑」。这就是本技能要干的事。

---

## 💪 Capabilities（分析能力）

### 模块 1️⃣：一句话总结

用大白话+类比告诉你这个项目到底是个啥。不是「本项目是一个分布式微服务架构解决方案」，而是「这玩意儿就像给程序员造了个自动炒菜机，你准备好食材（代码），它自动帮你炒出一桌菜（部署上线）」。

**格式要求**：
- 必须用「这个项目就像___，___」的句式开头
- 长度控制在 50-80 字
- 让小白一听就懂在说什么

---

### 模块 2️⃣：项目名片

给项目做个「身份证」，一眼看清基本信息：

| 字段 | 说明 |
|------|------|
| 项目名称 | GitHub 上显示的名字 |
| 作者/团队 | 谁做的，很重要吗？ |
| ⭐ Star 数 | 圈子里的人气指标，越高越香 |
| 🍴 Fork 数 | 有人抄作业吗？说明有价值 |
| 📅 最后更新时间 | 这项目还活着吗？ |
| 🐛 主要语言 | Python/Java/Go/TS... |
| 📍 定位 | 工具库/框架/应用/系统... |

---

### 模块 3️⃣：目标用户

不是所有人都适合用这个项目！我们会告诉你：

- **🎯 谁最该用**：学生/初级开发者/某行业从业者/特定场景
- **🤔 谁可以考虑**：有点折腾精神也能玩
- **🚫 谁别碰**：纯新手/完全用不上的人

**具体场景**：比如「如果你想给个人博客加个暗色模式，用这个就对了；但如果你要搭建电商平台，请出门左转找 Shopify」

---

### 模块 4️⃣：核心能力解读

这是重头戏！我们会：

1. **用大白话讲清楚它是干嘛的**：不拽术语，说人话
2. **找个生活类比**：就像什么日常东西
3. **对比同类项目**：它有什么独门绝技

**类比示例库**（会在 references 里详细展开）：
- 微服务架构 → 就像外卖平台有专门商家接单、骑手送货、客服处理投诉
- 中间件 → 就像公司前台，不同部门的人找她转达信息
- API → 就像餐厅菜单，你点啥它上啥，不用进厨房
- Docker → 就像外卖打包盒，把你的菜装进去，到哪都能热着吃

---

### 模块 5️⃣：上手难度评测

四维度打分，每个维度 ⭐1-5星：

| 维度 | 评判标准 |
|------|----------|
| 📦 安装难度 | 5分钟搞定 ⭐ 还是折腾一天 ⭐⭐⭐⭐⭐ |
| 📚 学习曲线 | 有手就行 ⭐ 还是得啃文档 ⭐⭐⭐⭐⭐ |
| 📖 文档质量 | 教科书级别 ⭐ 还是看天书 ⭐⭐⭐⭐⭐ |
| 👥 社区支持 | 大神秒回 ⭐ 还是发帖没人理 ⭐⭐⭐⭐⭐ |

**换算表**：
- ⭐ = 5分钟 / 轻松 / 完美
- ⭐⭐⭐ = 30分钟 / 需要适应 / 还行
- ⭐⭐⭐⭐⭐ = 2小时以上 / 硬骨头 / 看运气

---

### 模块 6️⃣：实际测试报告

虽然我们不能真的跑代码，但会帮你：

1. **安装实录**：记录关键步骤和可能卡住的地方
2. **功能测试**：基于文档和社区反馈推断能干啥
3. **性能表现**：数据来源（官方benchmark/社区测试）
4. **踩坑清单**：已知的问题和避坑指南

---

### 模块 7️⃣：竞品对比

同类项目横向 PK，用表格说清楚：

| 对比维度 | 本项目 | 竞品A | 竞品B |
|----------|--------|-------|-------|
| 功能丰富度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 上手难度 | ⭐⭐ | ⭐⭐⭐⭐ | ⭐ |
| 性能表现 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 社区活跃度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 生态完善度 | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |

**结论**：适合 A 场景 vs 适合 B 场景

---

### 模块 8️⃣：活跃度与生命力

帮你在上车前判断：这项目还能跑多远？

| 指标 | 看什么 | 健康标准 |
|------|--------|----------|
| 🔄 更新频率 | 最后一次 commit 是啥时候 | 一个月内有更新 ✅ |
| 🐛 Issue 响应 | 提了 bug 多久有人理 | 一周内有人回复 ✅ |
| 👥 贡献者数量 | 多少人参与开发 | 10人以上更稳 ✅ |
| 🔥 Star 趋势 | 最近涨得快不快 | 稳步增长 ✅ |

**3年预测**：基于以上数据，给你一个「再战三年 / 小心维护 / 不建议入坑」的判断。

---

### 模块 9️⃣：综合评分

十分制打分，给懒人一个快速参考：

| 维度 | 得分 | 说明 |
|------|------|------|
| 实用性 | ⭐⭐⭐⭐⭐ 8/10 | 能解决实际问题吗？ |
| 易用性 | ⭐⭐⭐⭐⭐ 7/10 | 小白能上手吗？ |
| 稳定性 | ⭐⭐⭐⭐⭐ 9/10 | 会突然挂掉吗？ |
| 前景值 | ⭐⭐⭐⭐⭐ 8/10 | 未来还有戏吗？ |
| **总评** | **8/10** | **值得一试** |

---

### 模块 🔟：落地应用建议

最后给你落地指南：

**✅ 推荐场景**：
- 场景 A：个人项目快速上手
- 场景 B：中小企业技术选型

**❌ 不推荐场景**：
- 超大规模项目
- 需要 7x24 运维但你只有一个人

**🚀 快速上手 3 步**：
1. `npm install xxx` - 安装
2. `npx xxx init` - 初始化
3. 改两行配置，跑起来！

**🎮 进阶玩法**：
- 插件生态怎么玩
- 二次开发注意事项
- 生产环境部署避坑

---

## 📥 Input Requirements（输入要求）

### 必需输入
- **GitHub 项目 URL**：直接丢链接，如 `https://github.com/facebook/react`

### 可选输入
- **`快速版` 关键词**：加上这仨字，只输出模块 1/2/5/9，省时间
- **特别关注维度**：比如「帮我重点看看这项目适不适合数据分析师用」

---

## 📤 Output Formats（输出格式）

### 文件规范
- **格式**：Markdown (.md)
- **命名**：`GitHub项目名-分析报告.md`
- **路径**：`./GitHub项目分析/`

### 排版规范
- 模块之间用 `---` 分隔线隔开
- 评分用 ⭐ 星级 + 数字双重表示
- 每个模块末尾必须有「一句话结论」框

### 一句话结论模板
```
💡 一句话结论：[80字以内核心判断]
```

---

## 📖 How to Use（使用方法）

### 完整版分析
```
用户：帮我分析这个项目 https://github.com/tailwindlabs/tailwindcss
```

### 快速版分析
```
用户：快速分析 https://github.com/vuejs/core
```

### 指定关注维度
```
用户：分析这个项目，特别关注适不适合团队协作场景
https://github.com/vercel/next.js
```

---

## 🛠 Scripts（脚本说明）

**本技能为框架指导型，无需 Python 脚本**

执行流程完全基于 LLM 阅读理解 + 联网搜索能力，不需要额外脚本。

---

## ✅ Best Practices（风格指南）

### 必须遵守
1. **复杂概念必须配生活类比**：每个技术术语出现时，后面必须跟「就像...」句式
2. **禁止晦涩术语直接出现**：如必须出现，必须紧跟大白话解释
3. **类比格式固定**：「就像___」的句式
4. **评分直观具体**：用 ⭐ + 数字，不用「还不错」「挺好的」这种模糊词
5. **模块末尾必须有一句话结论**：方便赶时间的人

### 语气风格
- 像朋友聊天，不像写论文
- 可以用「这玩意儿」「搞定」「搞起来」这种口语
- 该吐槽就吐槽（「文档写得跟天书似的」）
- 该夸就夸（「这设计绝了」）

### 输出语言
- **全部中文输出**
- 技术名词保留英文原文（约定俗成的如 API/SDK/CSS）

---

## ⚠️ Limitations（局限性说明）

1. **无法实际运行代码**：测试报告基于 README、文档、社区讨论推断，非实机验证
2. **竞品对比可能不全**：只对比主流公开项目，小众项目可能遗漏
3. **生命力预测非保证**：基于数据合理推测，不保证未来走向
4. **时效性限制**：项目状态会变化，建议结合最新信息判断

---

## 🔄 执行流程

### Step 1：信息抓取
用 `fetch_web` 读取 GitHub 项目页面，提取：
- README 文档
- Star/Fork/Watch 数据
- 最近提交时间
- Issues 数量
- 贡献者列表
- 主要编程语言

### Step 2：背景调研
用 `search_web` 搜索：
- 该项目的评测/对比文章
- 用户使用经验分享
- 已知问题和踩坑记录

### Step 3：竞品调研
用 `search_web` 搜索同类项目，建立对比基础

### Step 4：综合分析
按照 10 大模块框架，综合所有信息撰写报告

### Step 5：输出交付
- 生成 Markdown 格式报告
- 保存到 `./GitHub项目分析/` 目录
- 文件名：`项目名-分析报告.md`

---

**准备好了吗？扔给我一个 GitHub 链接，我们开始扒！** 🚀