用途:向 GitHub 拉取请求(PR)的某一行或某段行范围发布一条内联审查评论,底层通过 gh CLI 调用 GitHub REST API 实现。适合只有一个具体发现、需要精确锚定到某行代码的场景;若需审查整个 PR 并批量输出多条评论,应改用 pr-review 技能。
主要能力:支持单行评论;支持从 start_line 到 line 的多行范围评论;支持附加一键 suggestion 建议块;返回评论的 html_url。
使用方式:先用 fetch-diff 技能获取带行号的 PR diff,确定 path、line 和 side。side=RIGHT 表示新增或上下文行(合并后的文件,最常见),side=LEFT 表示被删除的行(变更前的文件)。单行评论命令:gh api repos/<owner>/<repo>/pulls/<pr_number>/comments -f body=<comment> -f path=<file_path> -F line=<line_number> -f side=<side> -f commit_id="$(gh pr view <pr_number> --repo <owner>/<repo> --json headRefOid -q .headRefOid)" --jq '.html_url'。多行评论在此基础上增加 -F start_line=<first_line> 与 -f start_side=<side>,line 为范围最后一行。参数含义:path 为相对仓库根的文件路径,且必须在 PR diff 中有对应 hunk;line 为锚定行(多行时为范围末行);side 取 RIGHT 或 LEFT;start_line/start_side 仅多行评论使用;commit_id 为 head commit SHA,通过 gh pr view 内联解析。
最佳实践:简单修复可用 suggestion 块,以三个反引号加 suggestion 包裹并严格保留原缩进;重复问题只留一条代表性评论,不必逐处标记;报告 bug 时说明问题、影响和具体修复方案;评论正文须以“🤖 Generated with Claude”单独一行结尾。
限制:资料未提供该技能的安装方式、依赖版本、权限要求、错误处理、收费或平台支持范围等信息。