Agent Skills › block/buzz › github-research

github-research

GitHub

利用 gh CLI 搜索 GitHub Issue、PR 及代码，评估信号优先级并生成结构化研究报告，辅助技术决策与方案调研。

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

Trigger Scenarios

需要查找特定功能或 bug 的现有实现调研开源项目的设计模式与维护者决策确认某技术方案是否已有社区实践

Install

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

More Options

Non-standard path

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

Use without installing

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.