mcpField
G
gh-cli

gh-cli

github.com/fredrikaverpil开发25955 次安装3 天前更新
代码仓库

关于 gh-cli

gh-cli 是补充 gh 命令行官方手册的使用指南，面向需要借助 gh 处理 GitHub 任务的用户。它强调控制列表输出、脚本化 JSON，以及通过 gh api 提交 PR 行内评论。

主要功能

  1. 01列表命令指定结果数量上限
  2. 02脚本输出使用 --json 和 jq
  3. 03通过 gh api 添加 PR 行内评论
  4. 04提交评审前先读取差异

适用场景

  1. 01精简 PR、Issue 和运行记录列表
  2. 02将 gh 输出用于脚本处理
  3. 03为 PR 差异行提交评论

安装

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

$npx skills add https://github.com/fredrikaverpil/dotfiles --skill gh-cli

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

详细介绍

gh CLI

gh --help 和 https://cli.github.com/manual 涵盖了命令范围。本技能仅介绍它们未涵盖的内容。

约定

  • 在每个列表命令（pr list、issue list、run list）中传入 --limit N。 默认值会输出远超终端所需的内容。
  • 当输出要供脚本使用时，使用 --json FIELDS；然后从那里管道传给 jq。

添加行级评论来审查 PR

gh pr review 只能提交总体正文。行内评论需要使用 gh api， 它会在一次调用中发布评论和摘要。先阅读差异（gh pr diff NUMBER）， 然后：

gh api repos/{owner}/{repo}/pulls/NUMBER/reviews --input - <<'EOF'
{
  "commit_id": "LATEST_COMMIT_SHA",
  "event": "COMMENT",
  "body": "Overall: solid changes with a few suggestions.",
  "comments": [
    {
      "path": "src/example.go",
      "line": 42,
      "side": "RIGHT",
      "body": "This variable is unused."
    }
  ]
}
EOF

新增内容的 side 为 RIGHT，删除内容的 side 为 LEFT；多行评论需添加 start_line 和 start_side。body 可以包含 GitHub 建议块 （```suggestion），用于提出替换代码。

event 可以是 COMMENT、APPROVE 或 REQUEST_CHANGES——提交前先问我选哪一个， 默认使用 COMMENT。

评论

支持 Markdown