Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Incomplete PR feedback API surface in github-code skill

オープン 初心者向け
  • 何か問題がありますか？
#359 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
72/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
github, graphql, markdown, shell
領域
api, developer-experience, documentation

調査の方向性

github-code skill の api-surface.md から始め、そこに記載されている PR フィードバックのエンドポイントと、issue に列挙されている REST および GraphQL の呼び出しを比較します。Complete PR Feedback Retrieval セクション、ページネーションのガイダンス、gh pr view の制限事項、提案された変更に関する注記、リアクションと直接参照の網羅を追加します。列挙されているすべてのフィードバックソースとスレッドの状態の詳細が正確にドキュメント化されていれば完了です。

索引モデルが issue の本文から書いたものです。

説明

The github-code skill's api-surface.md only documents 2 of ~8 endpoints needed for complete PR feedback retrieval. This causes the agent to miss inline review comments, review thread state, and conversation comments when inspecting PRs.

Gaps

  • No reviewThreads GraphQL query — REST cannot expose isResolved, isOutdated, or resolvedBy. This is GraphQL-only and completely missing from the surface.
  • No warning that gh pr view --json reviews omits inline review comments — --json comments returns conversation comments only, --json reviews returns review summaries only. Inline code review comments require /pulls/{number}/comments or GraphQL reviewThreads/reviews.comments.
  • Missing /issues/{number}/comments — conversation comments live at the issues endpoint, not /pulls/{number}/comments (which is inline review comments only). REST equivalent is undocumented.
  • Missing review-scoped comments endpoint — GET /pulls/{number}/reviews/{review_id}/comments for walking from a review to its inline comments.
  • Missing direct lookup endpoints — single review comment, single review, single issue comment by ID.
  • Missing pagination guidance — no --paginate documentation; PRs with heavy review activity silently truncate.
  • Missing suggested changes note — suggested changes are embedded in review comment body as markdown suggestion fences, not a separate endpoint.
  • Missing reactions endpoints — /pulls/comments/{comment_id}/reactions and /issues/comments/{comment_id}/reactions.

Recommended Fix

Add a "Complete PR Feedback Retrieval" section with:

REST minimum (3 paginated calls):

gh api --paginate repos/{owner}/{repo}/issues/{number}/comments    # conversation comments
gh api --paginate repos/{owner}/{repo}/pulls/{number}/reviews      # review summaries
gh api --paginate repos/{owner}/{repo}/pulls/{number}/comments     # inline review comments

GraphQL for thread state (1 call):

pullRequest(number: N) {
  comments(first: 100) { ... }
  reviews(first: 100) { ... }
  reviewThreads(first: 100) {
    nodes { isResolved isOutdated path line comments(first: 100) { ... } }
  }
}

Add explicit warning about gh pr view --json field limitations.

Full analysis: https://sentry.slack.com/docs/T024ZCV9U/F0B44A567QE

Action taken on behalf of David Cramer.

主要言語
TypeScript
スター
367
フォーク
41
平均マージ
6時間 9分
マージ済み PR（30日）
188

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

getsentry/junior のほかの issue

getsentry/junior の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。