Support standalone inline PR review comments

未关闭
#3,485 3 条评论 2 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 2 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
55/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
github, go

调研方向

Start by reading the existing pull request review and comment tool implementations and their tests to see how they handle GitHub API parameters and validation. Then compare that workflow with the REST endpoint described in the issue. Done means a tool can create a standalone inline comment with the listed location parameters, without creating or submitting a review.

由索引模型根据 Issue 内容生成。

描述

enhancement
Describe the feature or problem you'd like to solve

GitHub's UI allows posting an inline PR comment using "Add single comment", without starting or submitting a pull request review.

With github-mcp-server, the currently supported workflow for inline comments appears to be review-oriented:

  1. Create a pending review
  2. Add comments using add_comment_to_pending_review
  3. Submit the review

This makes sense when an agent is performing a complete code review, but not every inline observation necessarily represents a review.

For example, an agent may simply want to leave a comment such as:

Consider extracting this into a separate method.

on a specific line and continue its workflow.

Currently, doing this requires creating and subsequently submitting a review, which introduces additional state and has different semantics from GitHub's native "Add single comment" functionality.

Proposed solution

Expose a tool for creating a standalone inline pull request review comment, for example:

create_pull_request_review_comment

The tool could map to GitHub's existing REST API:

POST /repos/{owner}/{repo}/pulls/{pull_number}/comments

and accept the corresponding parameters such as:

  • repository
  • pull request number
  • comment body
  • commit SHA
  • file path
  • line / side
  • optional start line / start side for multi-line comments

This would allow both workflows:

  • Standalone inline comment — equivalent to GitHub's "Add single comment"
  • Pending review comments — comments intentionally grouped into a review
Example prompts or workflows (for tools/toolsets only)

An agent inspecting a PR notices one localized issue and wants to comment directly on the relevant line:

This timeout is hard-coded. Should this use the configured request timeout instead?

The desired behavior would be to publish that comment immediately on the relevant line, without creating a pending review or requiring a subsequent review submission.

Additional context

I noticed that github-mcp-server explicitly supports and encourages the pending-review workflow, so the absence of standalone inline comments may be an intentional design decision.

If so, it would be useful to understand whether there is a technical, security, or agent-workflow reason for not exposing GitHub's standalone inline-comment API.

This request is not intended to change or replace add_comment_to_pending_review. It is about exposing the separate GitHub capability for cases where an agent wants to publish an individual inline comment without creating a review.

主要语言
Go
星标
34.4k
派生
5.3k
平均合并
3 天 10 小时
30 天内合并 PR
11

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

github/github-mcp-server 的其他 Issue

查看 github/github-mcp-server 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。