github-prior-artlisted
Install: claude install-skill WuShuiYDF/github-prior-art
# GitHub 同类项目调研
用户想造的轮子,先去 GitHub 找现成的。产出一份带五档裁决的调研报告,落盘 `prior-art-report.md`。
## 铁律
- **激活即全量**:被触发就没有"简查"档,直接按全流程查透;用户中途喊停就停。
- **禁止凭记忆报数据**:候选仓库的名称、star、license、活跃度必须来自本次会话实际抓到的结果。记忆里的项目必须先用 API 验证才能进候选表;验证不到就别写,或标 `[未验证]`。
- **报告落盘,聊天从简**:完整内容写进当前项目 `prior-art/<主题-slug>-<YYYYMMDD>.md`,聊天里只给裁决 + Top 候选小表 + 一句理由。
- **只管代码项目**:如果用户想调研的其实是论文、SaaS 竞品等非代码目标,说明本 skill 面向 GitHub 代码项目,转普通联网调研,不要硬套下面的流程。
## 流程
### 1. 澄清(最多问 3 个)
从用户的话里提取,能推断的不要问:
- must-have 功能清单(凑不满 3 条时问)
- 技术栈约束(语言 / 框架 / 部署形态)
- 用途:纯学习 vs 长期维护 / 商用——决定 license 检查的严格度,以及 FORK 和 REFERENCE 之间的倾向
### 2. 关键词展开
- 3~8 组**英文短查询**,每组 2~3 个词。GitHub 搜索是 AND 语义,长句搜不到东西
- 用户说的是中文、GitHub 内容以英文为主:必须做一次中→英翻译;另保留 1 组中文关键词捞国产项目
- 用户指定语言时加 `language:python` 这类限定符
- 追加一组 `awesome <领域>` 搜精选清单
### 3. 搜索(并行,预算内)
通道按序降级,前面的可用就不用后面的:
1. `gh api search/repositories?q=...`(已登录,5000 次/时)
2. `curl -s "https://api.github.com/search/repositories?q=<query>&per_page=10"`(匿名,搜索 10 次/分,并行发也注意别超)
3. WebFetch 抓 github.com 仓库页(最慢,只做兜底)
4. WebSearch 一轮 `best open source <领域> <用途>`,捞 GitHub 搜索漏掉的知名项目
- 预过滤:`stars:>20 pushed:>YYYY-01-01`(往前推一年),先砍掉死项目
- 预算:搜索类调用 ≤10 次,全程 API 调用 ≤25 次;多组查询并行发,省墙钟时间
- 把实际用过的查询词记下来,写进报告(可复现、可自己调整重跑)
### 4. 粗筛
- 按语义重合度留 ≤10 个:30★ 的精确匹配 > 5k★ 的跑题项目
- 明显跑题的丢进"已排除"名单(写进报告,证明搜过了)
### 5. 深查 Top 3~5
每个候选抓:README、`pushed_at`、贡献者数、`license` 字段、issues 开闭比、最近 release。
```
curl -s https://api.github.com/repos/OWNER/REPO
curl -s -H "Accept: application/vnd.github.raw" https://api.github.com/repos/OWNER/REPO/readme