Agent Skills › block/buzz › github-research

github-research

GitHub

利用gh CLI搜索GitHub上的Issue、PR和代码，评估信号强度并生成包含关键发现与空白的研究报告，用于探索先例和实施模式。

examples/meadow-core/skills/github-research/SKILL.md block/buzz

触发场景

需要调研GitHub上的相关实现或问题查询特定仓库的代码或讨论历史

安装

npx skills add block/buzz --skill github-research -g -y

更多选项

非标准路径

npx skills add https://github.com/block/buzz/tree/main/examples/meadow-core/skills/github-research -g -y

不安装直接使用

npx skills use block/buzz@github-research

指定 Agent (Claude Code)

npx skills add block/buzz --skill github-research -a claude-code -g -y

安装 repo 全部 skill

npx skills add block/buzz --all -g -y

预览 repo 内 skill

npx skills add block/buzz --list

SKILL.md

Frontmatter

{
    "name": "github-research",
    "description": "Search GitHub issues, PRs, and code using the gh CLI."
}

GitHub Research

Search GitHub for prior art, implementation patterns, and maintainer decisions.

Commands

# Search issues
gh search issues "topic" --repo owner/repo --limit 20 \
  --json number,title,state,url

# Search merged PRs (highest signal)
gh search prs "topic" --repo owner/repo --merged --limit 20 \
  --json number,title,url

# Search code (use query syntax for path filtering)
gh search code "pattern path:src/" --repo owner/repo --limit 20 \
  --json path,textMatches

# Get full issue or PR details
gh issue view 123 --repo owner/repo --json number,title,body,comments
gh pr view 456 --repo owner/repo --json number,title,body,reviews,files

Rate Limits

Search API: 30 requests/minute
Check with: gh api rate_limit --jq '.resources.search'

Signal Ranking

Merged PRs — decisions that shipped
Maintainer comments — authoritative
Closed issues with solutions — problems solved
Open issues — current problems (lower signal)

Report Format

## Research: [Topic]

### Summary
- Key finding 1 [#123]
- Key finding 2 [PR #456]

### Findings
1. **#123: [Title]** — [summary]. URL: https://...
2. **PR #456: [Title]** — [what it changed]. URL: https://...

### Gaps
- [What you looked for but didn't find]

Always include URLs. If nothing relevant exists, say so.