Skill: liderongyao-crypto/skill-github-project-analyzer (version 1.0.0)

--- 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 链接，我们开始扒！** 🚀

path: references/analysis-framework.md
content: # GitHub 项目深度分析 - 详细框架参考

> 本文档是给执行技能的 Agent 看的详细参考，包含每个模块的具体分析维度、评分标准、类比示例等。

---

## 📋 模块 1：一句话总结

### 分析维度

1. **项目本质**：这项目到底是个啥（工具/库/框架/应用/系统）
2. **核心功能**：它主要能干啥
3. **使用场景**：在什么情况下你会用它
4. **目标用户**：谁会用它

### 句式模板

```
这个项目就像【日常事物】，
它能帮你【具体做什么】，
适合【什么场景】的人用。
```

### 示例

**React**：
> 这个项目就像给你的网页装了个「智能变脸器」，网页内容想怎么变就怎么变，不用刷新整个页面。适合做复杂交互网站的程序员用。

**Docker**：
> 这个项目就像给你的软件做了一个「万能打包盒」，不管什么口味的菜（软件），打包好就能在任何厨房（电脑）里热着吃。

**Tailwind CSS**：
> 这个项目就像给你一套「乐高积木式装修方案」，不用自己调颜色量尺寸，直接拼现成的积木块就能装修出漂亮的网页。

---

## 📋 模块 2：项目名片

### 必须提取的字段

| 字段 | 来源 | 说明 |
|------|------|------|
| 项目名称 | GitHub 页面标题 | 注意大小写 |
| 官方描述 | GitHub 副标题 | 官方怎么定位自己 |
| 作者/组织 | Owner 信息 | 个人还是公司 |
| Star 数 | 页面右上角 | 人气指标，越高越香 |
| Fork 数 | 页面右上角 | 有人抄作业吗 |
| Watch 数 | 页面右上角 | 有人在盯着更新吗 |
| 最后更新时间 | Insights > Traffic | 最近 commit 时间 |
| 主要语言 | 顶部标签 | 哪种语言写的 |
| Issues 数 | Issues 页面 | 活跃度指标 |
| Pull Requests 数 | PR 页面 | 社区参与度 |
| License | 顶部 | 开源协议 |
| 贡献者数量 | Insights > Contributors | 多少人参与 |

### 快速扫描技巧

- Star > 10k：热门项目，可信度高
- Star > 50k：明星项目，闭眼入
- Fork > Star 1/3：实用性强，大家都在改
- 每月更新：维护状态良好
- 两年没更新：谨慎考虑

---

## 📋 模块 3：目标用户

### 三层次分析法

#### 第一层：🎯 谁最该用（核心用户）

回答：谁用这个项目最爽？

**分析维度**：
- 技术背景：什么水平的开发者
- 使用场景：什么具体场景
- 需求类型：解决什么痛点
- 收益程度：能获得多大收益

#### 第二层：🤔 谁可以考虑（边缘用户）

回答：什么条件下可以用？

**分析维度**：
- 需要什么前置技能
- 投入产出比是否值得
- 有没有替代方案
- 学习成本能否接受

#### 第三层：🚫 谁别碰（不适用用户）

回答：什么情况下绝对不要用？

**分析维度**：
- 需求完全不匹配
- 技术栈完全不兼容
- 规模完全不适合
- 团队能力完全达不到

### 场景化表达模板

```
【场景化描述】

比如：
• 你是个刚学编程的小白，想给简历加点料 → ❌ 别用，太硬核
• 你在创业公司，要快速做个 MVP → ✅ 太适合了
• 你是大厂螺丝钉，负责维护祖传代码 → 🤔 看情况，不建议主动迁移
```

---

## 📋 模块 4：核心能力解读

### 核心功能类比表模板

| 原术语 | 生活类比 | 大白话解释 |
|--------|----------|------------|
| 术语 A | 就像 ○○ | 它就是 ○○，帮你 ○○ |
| 术语 B | 就像 △△ | 说白了就是 △△，好处是 ○○ |

### 类比库（常用概念）

| 技术概念 | 生活类比 | 大白话解释 |
|----------|----------|------------|
| 微服务架构 | 外卖平台 | 有专门商家接单、骑手送货、客服处理投诉，一个环节挂了不影响其他 |
| 中间件 | 公司前台 | 不同部门的人找她转达信息，她知道谁该找谁 |
| API | 餐厅菜单 | 你点啥它上啥，不用进厨房也不用知道菜怎么做 |
| 开源 | 共享菜谱 | 大家都能看、都能做、都能改，改完还能贡献回去 |
| Docker | 外卖打包盒 | 把你的菜装进去，到哪都能热着吃，保证味道不变 |
| CI/CD | 流水线工厂 | 产品从组装到包装到发货全自动，不用人工盯着 |
| 框架 | 毛坯房 | 给你做好了地基和墙，你只需要刷墙摆家具 |
| 插件/Plugin | 手机壳 | 原厂壳太单调，加个壳就能防水防摔加功能 |
| SDK | 工具箱 | 里面钳子螺丝刀锤子都有，干活直接拿来用 |
| 容器化 | 集装箱运输 | 不管什么货物，装进集装箱就能上船上车，标准化 |
| 微内核 | 积木底座 | 只有最核心的几块积木，其他你自己搭 |
| 异步编程 | 订外卖不等餐 | 下单后去干别的，外卖到了手机通知你 |
| 缓存 | 随身带零食 | 不用每次都去超市，随手就能吃 |
| 负载均衡 | 医院分诊台 | 病人来了根据情况分流，不会都挤在一个科室 |
| 分布式 | 连锁店 | 每家店都能服务，不用都去总店排队 |
| 消息队列 | 快递柜 | 发件人放进去，收件人随时取，不用双方同时在线 |
| 依赖注入 | 自动贩卖机 | 你选什么，它就吐出什么，不用自己找 |
| 观察者模式 | 订报纸 | 订阅了就天天送，不想看了退订 |
| 单例模式 | 公厕纸巾盒 | 整个系统就一个，谁用都是这个，用完自动补充 |
| 工厂模式 | 富士康流水线 | 同一个流水线，能生产手机也能生产平板 |
| 代理模式 | 房产中介 | 不直接找房东，通过中介谈，省心 |
| 装饰器模式 | 手机壳+挂绳 | 在原有东西上加东西，不改原东西 |
| 前端框架 | 动态PPT | 不用手动换页，内容变了自动刷新展示 |

### 与同类项目对比的独门绝技

**分析模板**：

```
【项目名】的独门绝技：

1. 🔮 绝技一：......
   别人怎么做的：......
   它怎么做的：......
   
2. 🔮 绝技二：......
   别人怎么做的：......
   它怎么做的：......
   
3. 🔮 绝技三：......
   别人怎么做的：......
   它怎么做的：......
```

---

## 📋 模块 5：上手难度评测

### 四维度评分标准

#### 维度 1：📦 安装难度

| 星级 | 耗时 | 典型特征 |
|------|------|----------|
| ⭐ | 5分钟内 | `pip install xxx` / `npm install xxx` 搞定 |
| ⭐⭐ | 10分钟 | 简单配置一下就能跑 |
| ⭐⭐⭐ | 30分钟 | 需要装几个依赖，配几个环境变量 |
| ⭐⭐⭐⭐ | 1小时 | 得装多个工具链，可能踩几个小坑 |
| ⭐⭐⭐⭐⭐ | 2小时以上 | 依赖复杂，可能要编译，环境配置一堆 |

#### 维度 2：📚 学习曲线

| 星级 | 难度 | 典型特征 |
|------|------|----------|
| ⭐ | 有手就行 | 看 5 分钟 demo 就能跑 |
| ⭐⭐ | 轻松上手 | 官方 tutorial 过一遍就懂 |
| ⭐⭐⭐ | 需要适应 | 得看文档，有些概念要理解 |
| ⭐⭐⭐⭐ | 需要学习 | 得系统学一遍，看视频/文档 |
| ⭐⭐⭐⭐⭐ | 硬骨头 | 得啃书、跑源码、可能还得看论文 |

#### 维度 3：📖 文档质量

| 星级 | 质量 | 典型特征 |
|------|------|----------|
| ⭐ | 教科书级别 | 有视频教程、交互式文档、完整示例 |
| ⭐⭐ | 详细清晰 | README 写得很清楚，有基本教程 |
| ⭐⭐⭐ | 中规中矩 | 有文档但不全，有些地方得自己摸索 |
| ⭐⭐⭐⭐ | 一般般 | 文档写得散，关键信息得找社区 |
| ⭐⭐⭐⭐⭐ | 看天书 | 文档缺失、过期、写得糊 |

#### 维度 4：👥 社区支持

| 星级 | 响应速度 | 典型特征 |
|------|----------|----------|
| ⭐ | 大神秒回 | Slack/Discord 活跃，issue 一天内回复 |
| ⭐⭐ | 比较活跃 | GitHub issue 一周内有人回 |
| ⭐⭐⭐ | 一般般 | 社区还行，但不一定能解决你的问题 |
| ⭐⭐⭐⭐ | 比较冷清 | 发帖可能没人理，得自己搞定 |
| ⭐⭐⭐⭐⭐ | 鬼城 | Issue 没人看，论坛没人回 |

### 综合上手难度计算

```
容易：4 个维度都是 ⭐ 或 ⭐⭐
中等：有 1-2 个 ⭐⭐⭐
较难：有 2-3 个 ⭐⭐⭐⭐
极难：有 3 个以上 ⭐⭐⭐⭐⭐
```

---

## 📋 模块 6：实际测试报告

### 安装实录模板

```
【系统环境】
- 操作系统：macOS Monterey / Windows 11 / Ubuntu 22.04
-  Node 版本：v18.x / Python 版本：3.10
-  网络环境：正常公司网络

【安装步骤】
1. [命令] xxx
   耗时：X 分钟
   状态：✅ 正常 / ⚠️ 有坑

2. [命令] xxx
   耗时：X 分钟
   状态：✅ 正常 / ⚠️ 有坑

【遇到的问题】
• 问题描述：......
  解决方法：......

【验证安装成功】
执行 [命令] 返回版本号即成功
```

### 功能测试清单模板

| 功能点 | 预期行为 | 测试结果 | 备注 |
|--------|----------|----------|------|
| 核心功能 A | 预期 ○○ | ✅ 符合预期 / ❌ 不符合 | |
| 核心功能 B | 预期 △△ | ✅ 符合预期 / ❌ 不符合 | |
| 边界情况 C | 预期 □□ | ⚠️ 部分符合 | |

### 性能表现（数据来源标注）

```
【数据来源说明】
• 官方 Benchmark：......
• 社区测试：......
• 个人测试：......

【测试结论】
• 启动速度：X 秒
• 内存占用：X MB
• 响应时间：X ms
• 并发能力：X QPS
```

### 踩坑清单模板

```
【已知踩坑点】

🔴 大坑（必须提前规避）
• 坑 1：......
  踩坑表现：......
  解决方法：......

🟡 中坑（影响体验）
• 坑 2：......
  踩坑表现：......
  解决方法：......

🟢 小坑（无伤大雅）
• 坑 3：......
  解决建议：......
```

---

## 📋 模块 7：竞品对比

### 竞品对比表格模板

| 对比维度 | 本项目 | 竞品 A | 竞品 B | 竞品 C |
|----------|--------|--------|--------|--------|
| **定位** | ○○○ | △△△ | □□□ | ▢▢▢ |
| **Star 数** | Xk | Xk | Xk | Xk |
| **功能丰富度** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| **上手难度** | ⭐⭐ | ⭐⭐⭐⭐ | ⭐ | ⭐⭐⭐ |
| **性能表现** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| **文档质量** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ |
| **社区活跃度** | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| **生态完善度** | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| **学习资源** | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| **适用场景** | A、B | C、D | E、F | G、H |

### 竞品对比结论模板

```
【选型建议】

选本项目的情况：
• 场景 1：......
• 场景 2：......

选竞品 A 的情况：
• 场景 1：......
• 场景 2：......

选竞品 B 的情况：
• 场景 1：......
• 场景 2：......
```

---

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

### 活跃度判断标准

#### 🔄 更新频率

| 状态 | 判断标准 | 建议 |
|------|----------|------|
| ✅ 活跃 | 1个月内有过 commit | 可以用 |
| ⚠️ 一般 | 3-6个月有过 commit | 可以用，但关注后续 |
| 🔴 不活跃 | 1年以上没更新 | 谨慎考虑，可能停止维护 |
| 💀 僵尸 | 2年以上没更新 | 不建议新入坑 |

#### 🐛 Issue 响应速度

| 状态 | 判断标准 | 建议 |
|------|----------|------|
| ✅ 活跃 | 7天内有人回复 | 遇到问题有人帮 |
| ⚠️ 一般 | 1个月内有人回复 | 可能需要等待 |
| 🔴 冷清 | 3个月无人问津 | 做好自力更生准备 |
| 💀 鬼城 | Issue 没人看 | 有问题自己解决 |

#### 👥 贡献者生态

| 状态 | 判断标准 | 建议 |
|------|----------|------|
| 活跃社区 | 50+ 贡献者 | 生态健康，多人维护 |
| 中等社区 | 10-50 贡献者 | 有人维护，问题不大 |
| 小众项目 | < 10 贡献者 | 依赖核心 maintainer |
| 个人项目 | 1-2 人维护 | 注意作者是否还在更新 |

#### 🔥 Star 趋势

判断方式：
- 看 Star 增长曲线
- 最近 30 天 / 90 天 / 365 天增长情况
- 持续增长 vs 增长停滞

### 3年生存预测

```
【基于以下指标的综合判断】

利好因素：
• ○○○
• ○○○

风险因素：
• △△△
• △△△

【3年预测】
乐观估计：⭐⭐⭐⭐⭐ 项目将继续活跃
中性估计：⭐⭐⭐ 项目将维持基本维护
保守估计：⭐⭐ 项目可能进入维护模式
风险估计：⭐ 可能停止维护

【建议】
• 如果你打算长期使用：建议 fork 一份自己维护
• 如果只是短期项目：放心用，三年内没问题
• 如果是核心业务依赖：建议有备选方案
```

---

## 📋 模块 9：综合评分

### 评分维度锚点标准

#### 维度 1：实用性（解决实际问题的能力）

| 分数 | 标准 |
|------|------|
| 9-10 | 能直接解决痛点，用了就能提效，省大量时间 |
| 7-8 | 能解决问题，需要一些适配工作 |
| 5-6 | 部分场景能用，不是万能的 |
| 3-4 | 概念大于实用，实际用起来费劲 |
| 1-2 | 基本不实用，用了反而更麻烦 |

#### 维度 2：易用性（上手难度）

| 分数 | 标准 |
|------|------|
| 9-10 | 新手看 10 分钟 demo 就能用起来 |
| 7-8 | 文档清晰，几天能入门 |
| 5-6 | 需要一定学习成本，得啃文档 |
| 3-4 | 学习曲线陡峭，新手劝退 |
| 1-2 | 极其难用，没有深厚背景根本搞不定 |

#### 维度 3：稳定性（可靠性）

| 分数 | 标准 |
|------|------|
| 9-10 | 成熟稳定，生产环境大量使用，极少出问题 |
| 7-8 | 比较稳定，有少量 bug 但可控 |
| 5-6 | 有些坑，但社区在积极修复 |
| 3-4 | 问题较多，生产环境使用要小心 |
| 1-2 | 各种坑，生产环境不建议使用 |

#### 维度 4：前景值（未来发展）

| 分数 | 标准 |
|------|------|
| 9-10 | 赛道热门，团队持续投入，社区活跃爆发期 |
| 7-8 | 稳步发展，有明确路线图，社区支持 |
| 5-6 | 维护状态，功能迭代放缓 |
| 3-4 | 增长乏力，可能被新技术取代 |
| 1-2 | 日落西山，不建议投入 |

### 总评计算方式

```
总评 = (实用性 × 0.3 + 易用性 × 0.25 + 稳定性 × 0.25 + 前景值 × 0.2)

四舍五入取整数
```

### 评分展示模板

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

| 维度 | 评分 | 说明 |
|------|------|------|
| 实用性 | ⭐⭐⭐⭐⭐ 8/10 | 能解决 XX 问题 |
| 易用性 | ⭐⭐⭐⭐ 7/10 | 文档清晰，上手较快 |
| 稳定性 | ⭐⭐⭐⭐⭐ 9/10 | 成熟稳定，坑少 |
| 前景值 | ⭐⭐⭐⭐ 8/10 | 赛道热门，持续更新 |
| **总评** | **8/10** | **值得一试** |

### 评分换算参考

| 总评分 | 推荐等级 | 说明 |
|--------|----------|------|
| 9-10 | ⭐⭐⭐⭐⭐ 强烈推荐 | 闭眼入，错过后悔 |
| 7-8 | ⭐⭐⭐⭐ 推荐 | 值得尝试，适合大多数场景 |
| 5-6 | ⭐⭐⭐ 可以试试 | 有条件地选择 |
| 3-4 | ⭐⭐ 斟酌使用 | 谨慎评估后再决定 |
| 1-2 | ⭐ 不推荐 | 坑太多，不值得花时间 |

💡 一句话结论：[综合判断，建议是否使用]
```

---

## 📋 模块 10：落地应用建议

### 推荐场景模板

```
【✅ 强烈推荐场景】

1. **场景名称**：......
   为什么推荐：......
   预期收益：......

2. **场景名称**：......
   为什么推荐：......
   预期收益：......
```

### 不推荐场景模板

```
【❌ 不推荐场景】

1. **场景名称**：......
   为什么不行：......
   建议替代：......

2. **场景名称**：......
   为什么不行：......
   建议替代：......
```

### 快速上手 3 步模板

```
【🚀 快速上手 3 步】

1️⃣ **安装准备**
   ```bash
   # 命令
   安装耗时：X 分钟
   前置条件：xxx
   ```

2️⃣ **跑起来**
   ```bash
   # 命令
   验证成功：看到 ○○ 就对了
   ```

3️⃣ **第一个小目标**
   完成 ○○ 功能
   预计耗时：X 分钟

【可能遇到的问题】
• 问题：......
  解决：......
```

### 进阶玩法模板

```
【🎮 进阶玩法】

1. **插件/扩展生态**
   推荐插件：......
   如何安装：......
   避坑提示：......

2. **二次开发**
   代码结构：......
   扩展点说明：......
   注意事项：......

3. **生产环境部署**
   容器化支持：✅/❌
   官方部署方案：......
   监控和日志：......
   备份策略：......
```

---

## 🎯 综合类比库（按技术领域分类）

### 基础架构类

| 概念 | 类比 | 解释 |
|------|------|------|
| 微服务 | 连锁餐厅 | 每个店独立运营，总部协调，不是一家店撑全场 |
| 单体应用 | 传统中餐大厨 | 炒菜洗碗收银全一个人，出菜全靠大厨状态 |
| 服务网格 | 餐厅智能调度系统 | 自动分配桌位、催单、处理投诉 |
| 分布式 | 多个小厨房合作 | 一个菜分段做，最后组装上桌 |
| 负载均衡 | 医院分诊台 | 看病不扎堆，根据情况分流 |
| 限流 | 景区入口闸机 | 人多了就排队，一批一批放进去 |
| 熔断 | 电表保险丝 | 过载就跳闸，防止整栋楼烧掉 |

### 开发工具类

| 概念 | 类比 | 解释 |
|------|------|------|
| Git | 时光机 + 多人协作记事本 | 能回到过去，能多人同时写不打架 |
| CI/CD | 自动化流水线 | 代码提交自动测试打包发布，不用人工盯 |
| Docker | 真空打包机 | 食物抽真空后到哪都能保存，原汁原味 |
| Kubernetes | 连锁店管理系统 | 很多店要统一管理，库存、人员、订单自动调度 |
| API | 奶茶店点单屏 | 你点单，店员做，你不知道后面怎么做 |
| SDK | 乐高工具箱 | 里面有各种零件，干活直接组装 |
| IDE | 高级厨房工作站 | 切菜炒菜调味一条龙，厨师专用 |
| 编译器 | 翻译机 | 你说中文，它翻译成英文，机器能听懂 |

### 前端技术类

| 概念 | 类比 | 解释 |
|------|------|------|
| 前端框架 | PPT 模板 | 做好了框架，往里填内容就行 |
| 组件化 | 乐高积木 | 一个个小零件，能拼出任何形状 |
| 虚拟 DOM | 剧本草稿 | 先在纸上改，改好了再上台演 |
| 响应式 | 自适应眼镜 | 近视远视都能看清，不用换眼镜 |
| 状态管理 | 共享记事本 | 所有人看同一本笔记，保持同步 |
| 单页应用 | 不刷新换台的电视 | 频道变了画面变了，但没换台 |

### 数据库类

| 概念 | 类比 | 解释 |
|------|------|------|
| 关系型数据库 | Excel 表格 | 行行列列，关联查询很方便 |
| NoSQL | 自由格式笔记本 | 想写啥写啥，不用按格子填 |
| 缓存 | 随身带零食 | 不用每次去超市，随手就能吃 |
| 索引 | 书的目录 | 不用一页页翻，直接跳到想看的地方 |
| 事务 | 转账操作 | 要么全成功，要么全失败，不能少一半 |

### 通用概念类

| 概念 | 类比 | 解释 |
|------|------|------|
| 开源 | 共享菜谱 | 大家都能看、都能做、都能改 |
| 框架 | 毛坯房 | 做好了地基和墙，你负责装修 |
| 库/类库 | 工具箱 | 里面钳子螺丝刀锤子，干活直接拿来用 |
| 设计模式 | 常见菜谱 | 有些菜大家常做，做法固定下来就是模式 |
| 架构 | 盖楼图纸 | 决定用什么材料、怎么盖、能盖多高 |
| 重构 | 装修 | 房子结构不变，重新刷墙换家具 |
| 技术债 | 信用卡欠款 | 当时买的时候爽，现在还利息心累 |

---

## 📊 评分锚点速查表

### 星级与时间的对应关系

| 星级 | 安装耗时 | 解决问题耗时 | 典型场景 |
|------|----------|--------------|----------|
| ⭐ | < 5分钟 | < 10分钟 | `pip install xxx` 搞定 |
| ⭐⭐ | 5-15分钟 | 10-30分钟 | 简单配置 |
| ⭐⭐⭐ | 15-30分钟 | 30分钟-2小时 | 看文档能解决 |
| ⭐⭐⭐⭐ | 30-60分钟 | 2-4小时 | 需要查社区 |
| ⭐⭐⭐⭐⭐ | > 1小时 | > 4小时 | 看源码/问人都难 |

### 星级与质量的对应关系

| 星级 | 文档质量 | 社区活跃度 | 生态完善度 |
|------|----------|------------|------------|
| ⭐ | 教科书级别 | 热闹非凡 | 非常完善 |
| ⭐⭐ | 详细清晰 | 比较活跃 | 基本完善 |
| ⭐⭐⭐ | 中规中矩 | 一般 | 部分生态 |
| ⭐⭐⭐⭐ | 一般般 | 比较冷清 | 生态较少 |
| ⭐⭐⭐⭐⭐ | 缺失/过时 | 鬼城 | 几乎没有 |

---

## ✅ 分析报告模板结构

```
# [项目名] 深度分析报告

> 分析时间：YYYY-MM-DD
> 分析版本：完整版/快速版

---

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

[内容]

💡 一句话结论：[80字以内]

---

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

[表格内容]

💡 一句话结论：[50字以内]

---

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

[三层次内容]

💡 一句话结论：[60字以内]

---

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

[类比 + 独门绝技]

💡 一句话结论：[60字以内]

---

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

[四维度评分]

💡 一句话结论：[50字以内]

---

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

[安装实录 + 功能测试 + 踩坑清单]

💡 一句话结论：[80字以内]

---

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

[对比表格 + 选型建议]

💡 一句话结论：[60字以内]

---

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

[指标 + 3年预测]

💡 一句话结论：[50字以内]

---

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

[评分表 + 换算参考]

💡 一句话结论：[40字以内]

---

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

[推荐/不推荐 + 快速上手 + 进阶玩法]

💡 一句话结论：[80字以内]

---

*本报告由 AI 自动生成，基于公开信息和合理推测，仅供参考。*
```


path: HOW_TO_USE.md
content: # GitHub 项目深度分析技能 - 使用指南

## 🎯 快速开始

直接把你的 GitHub 项目链接扔给我就行！

---

## 📝 使用示例

### 示例 1：完整版分析（推荐新手）

**你这么说**：
```
帮我分析一下 Tailwind CSS 这个项目
https://github.com/tailwindlabs/tailwindcss
```

**我会这么做**：
1. 先把项目页面扒一遍（Star数、更新时间、README 啥的）
2. 去网上搜搜别人怎么评价它的
3. 找几个同类竞品（Bootstrap、Material UI 这些）
4. 按照 10 大模块给你整一份完整报告

**你会得到**：
- 一份超详细的分析报告，包含所有 10 个模块
- 大白话解释，连隔壁大妈都能看懂
- 每个模块末尾的「一句话结论」
- 适合快速扫一眼就 get 到重点

---

### 示例 2：快速版分析（老手/赶时间用）

**你这么说**：
```
快速分析一下这个项目
https://github.com/vuejs/core
```

**我会这么做**：
只输出 4 个核心模块：
- 模块 1️⃣：一句话总结
- 模块 2️⃣：项目名片
- 模块 5️⃣：上手难度评测
- 模块 9️⃣：综合评分

**你会得到**：
- 3 分钟就能看完的精简版报告
- 适合对技术有一定了解，只需要快速判断值不值得入坑
- 决策用报告，细节不多但核心信息全

---

### 示例 3：指定关注维度（你有特别想了解的）

**你这么说**：
```
帮我分析 Next.js，特别关注一下团队协作和多人开发场景
https://github.com/vercel/next.js
```

**我这么做**：
1. 正常分析流程走一遍
2. 重点在「目标用户」「落地建议」等模块里加戏
3. 专门聊聊多人协作怎么玩、有没有版本控制支持、团队开发体验如何

**你会得到**：
- 完整版报告
- 额外增加对你关注维度的深入分析
- 比如问「适不适合数据分析师」，我会重点看数据处理相关功能

---

## 💡 更多问法

### 问法 A：只知道项目名，不知道链接
```
分析 React 项目
```
我能搜到官方链接并开始分析

### 问法 B：想对比两个项目
```
帮我对比一下 React 和 Vue
https://github.com/facebook/react
https://github.com/vuejs/core
```
我会给你出两份独立报告 + 竞品对比章节

### 问法 C：想了解某个具体功能
```
分析一下这个项目，想知道它的数据库支持怎么样
https://github.com/prisma/prisma
```
我会在报告中重点展开数据库相关的分析

---

## ⚠️ 注意事项

1. **我能做的**：帮你扒页面、搜评价、找竞品、写报告
2. **我做不到的**：
   - 实际运行代码（但能基于文档推断）
   - 帮你安装（但能告诉你怎么装、可能有哪些坑）
   - 预测未来（但能基于数据做合理推测）

3. **建议配合使用**：
   - 拿到报告后，自己去官方文档确认一下细节
   - 遇到具体问题，去 GitHub Issue 搜搜有没有人遇到过
   - 决定用之前，先跑个 Demo 试试水

---

## 🚀 开始使用

随便选一个你感兴趣的项目，扔链接过来吧！

**示例链接**：
- https://github.com/facebook/react
- https://github.com/tailwindlabs/tailwindcss
- https://github.com/vercel/next.js
- https://github.com/microsoft/TypeScript
- https://github.com/python/cpython
- 或者...任何你想了解的项目！


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)