Install
openclaw skills install skill-github-project-analyzerskill-github-project-analyzer
深度分析GitHub项目，输出大白话版项目评估报告；当用户提供GitHub链接或要求分析GitHub项目时使用
Audits
PassGitHub 项目深度分析技能
🎯 技能定位
想象你有个技术大牛朋友，你扔给他一个 GitHub 链接，他能帮你把这个项目扒得底朝天，然后用大白话告诉你：「这玩意儿是干啥的、值不值得学、有没有坑」。这就是本技能要干的事。
💪 Capabilities（分析能力）
模块 1️⃣：一句话总结
用大白话+类比告诉你这个项目到底是个啥。不是「本项目是一个分布式微服务架构解决方案」，而是「这玩意儿就像给程序员造了个自动炒菜机，你准备好食材（代码），它自动帮你炒出一桌菜（部署上线）」。
格式要求：
- 必须用「这个项目就像___，___」的句式开头
- 长度控制在 50-80 字
- 让小白一听就懂在说什么
模块 2️⃣：项目名片
给项目做个「身份证」，一眼看清基本信息：
| 字段 | 说明 |
|---|---|
| 项目名称 | GitHub 上显示的名字 |
| 作者/团队 | 谁做的，很重要吗？ |
| ⭐ Star 数 | 圈子里的人气指标，越高越香 |
| 🍴 Fork 数 | 有人抄作业吗？说明有价值 |
| 📅 最后更新时间 | 这项目还活着吗？ |
| 🐛 主要语言 | Python/Java/Go/TS... |
| 📍 定位 | 工具库/框架/应用/系统... |
模块 3️⃣：目标用户
不是所有人都适合用这个项目！我们会告诉你：
- 🎯 谁最该用：学生/初级开发者/某行业从业者/特定场景
- 🤔 谁可以考虑：有点折腾精神也能玩
- 🚫 谁别碰：纯新手/完全用不上的人
具体场景：比如「如果你想给个人博客加个暗色模式，用这个就对了；但如果你要搭建电商平台，请出门左转找 Shopify」
模块 4️⃣：核心能力解读
这是重头戏！我们会：
- 用大白话讲清楚它是干嘛的：不拽术语，说人话
- 找个生活类比：就像什么日常东西
- 对比同类项目：它有什么独门绝技
类比示例库（会在 references 里详细展开）：
- 微服务架构 → 就像外卖平台有专门商家接单、骑手送货、客服处理投诉
- 中间件 → 就像公司前台，不同部门的人找她转达信息
- API → 就像餐厅菜单，你点啥它上啥，不用进厨房
- Docker → 就像外卖打包盒，把你的菜装进去，到哪都能热着吃
模块 5️⃣：上手难度评测
四维度打分，每个维度 ⭐1-5星：
| 维度 | 评判标准 |
|---|---|
| 📦 安装难度 | 5分钟搞定 ⭐ 还是折腾一天 ⭐⭐⭐⭐⭐ |
| 📚 学习曲线 | 有手就行 ⭐ 还是得啃文档 ⭐⭐⭐⭐⭐ |
| 📖 文档质量 | 教科书级别 ⭐ 还是看天书 ⭐⭐⭐⭐⭐ |
| 👥 社区支持 | 大神秒回 ⭐ 还是发帖没人理 ⭐⭐⭐⭐⭐ |
换算表：
- ⭐ = 5分钟 / 轻松 / 完美
- ⭐⭐⭐ = 30分钟 / 需要适应 / 还行
- ⭐⭐⭐⭐⭐ = 2小时以上 / 硬骨头 / 看运气
模块 6️⃣：实际测试报告
虽然我们不能真的跑代码，但会帮你：
- 安装实录：记录关键步骤和可能卡住的地方
- 功能测试：基于文档和社区反馈推断能干啥
- 性能表现：数据来源（官方benchmark/社区测试）
- 踩坑清单：已知的问题和避坑指南
模块 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 步：
npm install xxx- 安装npx xxx init- 初始化- 改两行配置，跑起来！
🎮 进阶玩法：
- 插件生态怎么玩
- 二次开发注意事项
- 生产环境部署避坑
📥 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（风格指南）
必须遵守
- 复杂概念必须配生活类比：每个技术术语出现时，后面必须跟「就像...」句式
- 禁止晦涩术语直接出现：如必须出现，必须紧跟大白话解释
- 类比格式固定：「就像___」的句式
- 评分直观具体：用 ⭐ + 数字，不用「还不错」「挺好的」这种模糊词
- 模块末尾必须有一句话结论：方便赶时间的人
语气风格
- 像朋友聊天，不像写论文
- 可以用「这玩意儿」「搞定」「搞起来」这种口语
- 该吐槽就吐槽（「文档写得跟天书似的」）
- 该夸就夸（「这设计绝了」）
输出语言
- 全部中文输出
- 技术名词保留英文原文（约定俗成的如 API/SDK/CSS）
⚠️ Limitations（局限性说明）
- 无法实际运行代码：测试报告基于 README、文档、社区讨论推断，非实机验证
- 竞品对比可能不全：只对比主流公开项目，小众项目可能遗漏
- 生命力预测非保证：基于数据合理推测，不保证未来走向
- 时效性限制：项目状态会变化，建议结合最新信息判断
🔄 执行流程
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 链接，我们开始扒！ 🚀