diffing-pr-read

스타14

포크1

업데이트2026년 7월 19일 11:52

Read a GitHub pull request through diffing with token-efficient bounded inspect APIs instead of dumping gh pr view/diff or the full patch. Use when summarizing a PR, inspecting PR changes, preparing a review, or reading PR discussion with minimal context.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

ahmedragab20

ahmedragab20/diffing

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Read a GitHub PR through diffing (token-efficient)

Prefer diffing’s slim PR overview and bounded diff inspect over gh pr view, gh pr diff, or GET /api/diff full patches.

Setup

Target the correct repository. Prefer MCP review_session_status when available.
Ensure a PR session:
- Reuse when mode: gh-pr and the ref matches.
- Otherwise start: diffing --gh-pr <ref> --no-open (or diffing "gh pr <ref>" --no-open).
Do not replace a user-owned session bound to a different PR or local mode — report the conflict.

<ref> may be a number, owner/repo#N, or a full PR URL.

Token-efficient read ladder

Never load the full patch or full session JSON by default.

Step	MCP	CLI
Identity + counts	`gh_overview`	`diffing gh overview [--json]`
Patch totals	`diff_summary`	`diffing inspect summary`
File list	`diff_files` (page `nextCursor`)	`diffing inspect files --cursor N --limit 50`
Hunk map	`diff_hunks`	`diffing inspect hunks --file N --generation G`
Body rows	`diff_slice`	`diffing inspect slice --file N --start R --max-lines 120 --generation G`
Find text	`diff_search`	`diffing inspect search "literal" --generation G`
Discussion	`gh_list_threads` (`unresolvedOnly`)	`diffing gh threads --unresolved`
Verdicts	`gh_list_reviews`	`diffing gh reviews`

Rules

Carry generation from diff_summary into hunks/slice/search. On stale generation (HTTP 409), re-run summary and restart that file’s traversal.
Keep default or smaller line/byte budgets; raise only when necessary.
Continue slices with nextRow and file lists with nextCursor. Continue search with nextFile + nextRow.
Prefer gh_list_threads with unresolvedOnly: true and truncated bodies. Use fullBody / --full-body only for threads you will act on.
Compact JSON is default. Avoid --pretty and avoid GET /api/gh/session (fat UI payload).
get_diff / full GET /api/diff is an escape hatch only when inspect is unavailable.

Optional: leave review findings

This skill is read-first. To post draft review comments on the PR session, follow diffing-review (PR section): create drafts via gh_create_draft_comment / POST /api/gh/pr-session/comments, then publish only with explicit user authorization (gh_submit_review dry-run first).

CLI sketch

diffing --gh-pr 1234 --no-open
diffing gh overview --json
diffing inspect summary
diffing inspect files --limit 50
diffing inspect hunks --file 0 --generation <g>
diffing inspect slice --file 0 --start 0 --max-lines 120 --generation <g>
diffing gh threads --unresolved          # XML default
diffing gh reviews --format json

Anti-patterns

Dumping gh pr diff or the entire unified patch into context.
Calling GET /api/gh/session for “status” when gh overview exists.
Loading every resolved historical thread body when only unresolved feedback matters.
Starting a second PR server for the same ref when a compatible session is already live.

이 저장소의 다른 Skills

같은 저장소

diffing-pr-address

ahmedragab20/diffing

Turn GitHub pull-request review feedback into a human-approved local implementation through diffing. Use when asked to address PR comments, fix reviewer requests, turn unresolved PR feedback into a plan, or implement requested changes on a PR branch. Default to a local checkout plus plan/review cycle; reply, resolve, publish, or otherwise mutate GitHub only with explicit user authorization.

2026-07-1914

diffing-review

ahmedragab20/diffing

Review code with diffing, inspect every changed file, and post actionable inline feedback. Use when the user asks to review working-tree, staged, commit, branch, or GitHub pull-request changes through diffing.

2026-07-1914

diffing

ahmedragab20/diffing

Use diffing for a native human-AI review loop over local code changes, GitHub pull requests, or implementation plans. Route requests to start the UI, inspect and review diffs, submit plans for approval, wait for feedback, address inline comments, or operate any diffing CLI, MCP, or loopback HTTP capability.

2026-07-1914

diffing-finish-review

ahmedragab20/diffing

Receive a human's diffing review handoff, apply requested edits, answer questions, and keep comment threads synchronized. Use when the user says their review is ready, asks to process diffing comments, or wants the agent to wait for and address review feedback.

2026-07-1914

diffing-plan-review

ahmedragab20/diffing

Submit an implementation plan to diffing for human approval and obey the verdict before writing code. Use for plan sign-off, architecture review, risky work, or any request to let the human comment on a plan before implementation.

2026-07-1914

diffing-start-review

ahmedragab20/diffing

Start or reopen a diffing UI for local changes or a GitHub pull request and hand it to the human. Use when the user asks to open diffing, inspect changes in the review UI, start a review, or send work for human review.

2026-07-1914

name	diffing-pr-read
description	Read a GitHub pull request through diffing with token-efficient bounded inspect APIs instead of dumping gh pr view/diff or the full patch. Use when summarizing a PR, inspecting PR changes, preparing a review, or reading PR discussion with minimal context.

Read a GitHub PR through diffing (token-efficient)

Prefer diffing’s slim PR overview and bounded diff inspect over gh pr view, gh pr diff, or GET /api/diff full patches.

Setup

Target the correct repository. Prefer MCP review_session_status when available.
Ensure a PR session:
- Reuse when mode: gh-pr and the ref matches.
- Otherwise start: diffing --gh-pr <ref> --no-open (or diffing "gh pr <ref>" --no-open).
Do not replace a user-owned session bound to a different PR or local mode — report the conflict.

<ref> may be a number, owner/repo#N, or a full PR URL.

Token-efficient read ladder

Never load the full patch or full session JSON by default.

Step	MCP	CLI
Identity + counts	`gh_overview`	`diffing gh overview [--json]`
Patch totals	`diff_summary`	`diffing inspect summary`
File list	`diff_files` (page `nextCursor`)	`diffing inspect files --cursor N --limit 50`
Hunk map	`diff_hunks`	`diffing inspect hunks --file N --generation G`
Body rows	`diff_slice`	`diffing inspect slice --file N --start R --max-lines 120 --generation G`
Find text	`diff_search`	`diffing inspect search "literal" --generation G`
Discussion	`gh_list_threads` (`unresolvedOnly`)	`diffing gh threads --unresolved`
Verdicts	`gh_list_reviews`	`diffing gh reviews`

Rules

Carry generation from diff_summary into hunks/slice/search. On stale generation (HTTP 409), re-run summary and restart that file’s traversal.
Keep default or smaller line/byte budgets; raise only when necessary.
Continue slices with nextRow and file lists with nextCursor. Continue search with nextFile + nextRow.
Prefer gh_list_threads with unresolvedOnly: true and truncated bodies. Use fullBody / --full-body only for threads you will act on.
Compact JSON is default. Avoid --pretty and avoid GET /api/gh/session (fat UI payload).
get_diff / full GET /api/diff is an escape hatch only when inspect is unavailable.

Optional: leave review findings

CLI sketch

diffing --gh-pr 1234 --no-open
diffing gh overview --json
diffing inspect summary
diffing inspect files --limit 50
diffing inspect hunks --file 0 --generation <g>
diffing inspect slice --file 0 --start 0 --max-lines 120 --generation <g>
diffing gh threads --unresolved          # XML default
diffing gh reviews --format json

Anti-patterns

Dumping gh pr diff or the entire unified patch into context.
Calling GET /api/gh/session for “status” when gh overview exists.
Loading every resolved historical thread body when only unresolved feedback matters.
Starting a second PR server for the same ref when a compatible session is already live.