mcpField
G
github

github

github.com/letta-ai开发156120 次安装5 周前更新
代码仓库

关于 github

这项 Skill 指导 Agent 使用 `gh` 命令行处理 GitHub 仓库、议题、拉取请求、CI 和 API 查询，并区分这些操作与本地 Git 工作及代码审查。

主要功能

  1. 01检查拉取请求状态与审查
  2. 02查看 CI 运行和日志
  3. 03创建和管理议题
  4. 04创建并合并拉取请求
  5. 05使用 `gh api` 查询仓库数据

适用场景

  1. 01检查拉取请求是否可合并
  2. 02查看工作流失败日志
  3. 03整理待处理议题
  4. 04列出发布版本或协作者

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/letta-ai/skills --skill github

安装后在 Claude Code 中输入/github确认已加载。

附带文件assets/github-small.svgLICENSE

详细介绍

GitHub 技能

使用 gh CLI 与 GitHub 仓库、议题、PR 和 CI 交互。

适用场景

✅ 在以下情况下使用此技能：

  • 检查 PR 状态、评审情况或是否可以合并
  • 查看 CI/工作流运行状态和日志
  • 创建、关闭或评论议题
  • 创建或合并拉取请求
  • 查询 GitHub API 以获取仓库数据
  • 列出仓库、发行版或协作者

不适用场景

❌ 在以下情况下不要使用此技能：

  • 本地 git 操作（commit、push、pull、branch）→ 直接使用 git
  • 非 GitHub 仓库（GitLab、Bitbucket、可自托管）→ 使用其他 CLI
  • 克隆仓库 → 使用 git clone
  • 评审实际代码更改 → 使用 coding-agent 技能
  • 复杂的多文件差异 → 使用 coding-agent 或直接阅读文件

设置

# Authenticate (one-time)
gh auth login

# Verify
gh auth status

常用命令

拉取请求
# List PRs
gh pr list --repo owner/repo

# Check CI status
gh pr checks 55 --repo owner/repo

# View PR details
gh pr view 55 --repo owner/repo

# Create PR
gh pr create --title "feat: add feature" --body "Description"

# Merge PR
gh pr merge 55 --squash --repo owner/repo
议题
# List issues
gh issue list --repo owner/repo --state open

# Create issue
gh issue create --title "Bug: something broken" --body "Details..."

# Close issue
gh issue close 42 --repo owner/repo
CI/工作流运行
# List recent runs
gh run list --repo owner/repo --limit 10

# View specific run
gh run view <run-id> --repo owner/repo

# View failed step logs only
gh run view <run-id> --repo owner/repo --log-failed

# Re-run failed jobs
gh run rerun <run-id> --failed --repo owner/repo
API 查询
# Get PR with specific fields
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

# List all labels
gh api repos/owner/repo/labels --jq '.[].name'

# Get repo stats
gh api repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'

JSON 输出

大多数命令都支持使用 --json 输出结构化数据，并通过 --jq 进行筛选：

gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
gh pr list --json number,title,state,mergeable --jq '.[] | select(.mergeable == "MERGEABLE")'

模板

PR 评审摘要
# Get PR overview for review
PR=55 REPO=owner/repo
echo "## PR #$PR Summary"
gh pr view $PR --repo $REPO --json title,body,author,additions,deletions,changedFiles \
  --jq '"**\(.title)** by @\(.author.login)\n\n\(.body)\n\n📊 +\(.additions) -\(.deletions) across \(.changedFiles) files"'
gh pr checks $PR --repo $REPO
议题分类
# Quick issue triage view
gh issue list --repo owner/repo --state open --json number,title,labels,createdAt \
  --jq '.[] | "[\(.number)] \(.title) - \([.labels[].name] | join(", ")) (\(.createdAt[:10]))"'

注意事项

  • 不在 git 目录中时，始终指定 --repo owner/repo
  • 直接使用 URL：gh pr view https://github.com/owner/repo/pull/55
  • 存在速率限制；重复查询时使用 gh api --cache 1h

评论

支持 Markdown