name: github-project-search
description: 搜索GitHub开源项目以解决技术问题或寻找产品/技术方案。当用户需要：(1)寻找解决特定问题的开源库/工具，(2)探索某领域的最佳实践或参考实现，(3)寻找产品灵感或竞品参考，(4)查找特定技术栈的示例代码，(5)评估开源项目质量时使用。

GitHub 开源项目搜索

帮助用户在GitHub上搜索和评估开源项目，找到适合的技术方案或产品灵感。

搜索流程

1. 明确搜索目标

与用户确认搜索意图：
- 解决技术问题：需要什么功能？使用什么语言/框架？
- 寻找产品方案：目标用户是谁？核心功能需求？
- 学习最佳实践：哪个技术领域？什么场景？

2. 执行搜索

使用 WebSearch 工具搜索 GitHub 项目，构造有效的搜索词：

搜索模式示例：

# 按功能搜索
"github [功能描述] [语言/框架]"
例：github pdf parser python

# 按问题搜索
"github [问题关键词] solution"
例：github rate limiting solution nodejs

# 按产品类型搜索
"github open source [产品类型] self-hosted"
例：github open source crm self-hosted

# 按技术栈搜索
"github [技术栈] boilerplate/template/starter"
例：github nextjs tailwind starter

# Awesome列表搜索
"github awesome [领域]"
例：github awesome machine learning

搜索技巧：
- 添加 site:github.com 精确限定
- 使用 stars:>1000 筛选高质量项目（在GitHub站内搜索时）
- 添加年份如 2025 2026 获取最新项目
- 组合多个关键词缩小范围

3. 评估项目质量

找到项目后，使用 WebFetch 获取项目详情，按以下标准评估：

重点关注：
- README.md - 了解功能和用法
- package.json/requirements.txt - 检查依赖
- /examples 或 /demo - 查看示例代码
- Issues/Discussions - 了解常见问题
- Release频率 - 项目维护活跃度

4. 整理搜索结果

向用户提供结构化的搜索报告：

## 搜索结果: [搜索主题]

### 推荐项目

#### 1. [项目名](链接)
- ⭐ Stars: X | 📅 最近更新: X
- **简介**: 一句话描述
- **优势**: 主要优点
- **注意**: 潜在问题或限制
- **适用场景**: 什么情况下选择

#### 2. [项目名](链接)
...

### 对比总结
| 项目 | 优势 | 劣势 | 推荐场景 |
|------|------|------|----------|
| A | ... | ... | ... |
| B | ... | ... | ... |

### 建议
[基于用户需求的具体建议]

常见搜索场景

场景1: 寻找技术解决方案

用户问："需要一个Node.js的PDF生成库"

搜索策略：
1. 搜索 github nodejs pdf generation library
2. 查看 awesome-nodejs 中的 PDF 部分
3. 比较 puppeteer、pdfkit、pdf-lib 等方案

场景2: 寻找产品/系统参考

用户问："想做一个类似Notion的知识库系统"

搜索策略：
1. 搜索 github open source notion alternative
2. 搜索 github knowledge base self-hosted
3. 评估 outline、appflowy、affine 等项目

场景3: 寻找最佳实践

用户问："React项目的最佳目录结构"

搜索策略：
1. 搜索 github react project structure best practices
2. 查看知名React项目的目录结构
3. 搜索 github react boilerplate 2025

Awesome Lists 速查

常用的 Awesome 列表可作为搜索起点：

• awesome-selfhosted - 自托管软件合集
• awesome-react - React生态
• awesome-python - Python库合集
• awesome-go - Go语言生态
• awesome-nodejs - Node.js生态
• awesome-vue - Vue生态
• awesome-java - Java生态
• awesome-design - 设计资源
• awesome-sysadmin - 系统管理工具

搜索示例: github sindresorhus/awesome-[领域]

注意事项

1. License兼容性：商业项目注意避免GPL等强传染性协议
2. 维护状态：优先选择活跃维护的项目
3. 社区活跃度：关注Issue响应速度和PR合并情况
4. 安全性：检查是否有已知漏洞（可查看Security tab）
5. 依赖数量：依赖过多可能带来维护负担