Skip to content
IN-DEPTH TUTORIAL / 03

PR monitoring: current checks, reviews and merge status

Use five synthetic PR snapshots to practice stale check results, requested changes, drafts and unreadable records. Prepare actions before updating a board.

Prepared by shancha6 stages · Complete prompts5 practice files
On this page
  1. Inputs and complete outputs
  2. Preparation and capabilities
  3. Execution and takeover boundaries
  4. 01 Fix PR identity and observation time
  5. 02 Count only effective current-commit checks
  6. 03 Evaluate review, draft and merged dimensions separately
  7. 04 Write a report and a proposed board diff
  8. 05 Read current state again before a specific write
  9. 06 Follow meaningful changes without repeat noise
  10. Troubleshooting and acceptance
  11. Download practice files
  12. Sources and verification scope
THE RESULT

Check the input, then compare the complete deliverables

Explore the original materials, item-by-item outcomes and full report below. Attempt the input independently before using the reference to find omissions or disagreements.

Demonstration scope

The PR snapshots, commit ids and reference results below are synthetic. A separate read-only run on 2026-10-18 checked public PR #3 and its current-head checks and reviews. Notion writes, notifications, continuous monitoring and Routines remain untested; see the verification record.

PR monitoring practice
5 PRs · 1 unreadable

Original synthetic material. Try the input independently, then compare the reference results.

Original synthetic input
{
  "synthetic": true,
  "case": "github-pr-watch",
  "data": {
    "prs": [
      {
        "id": "PR12",
        "head": "new-b",
        "checks": [
          {
            "sha": "old-a",
            "status": "success"
          },
          {
            "sha": "new-b",
            "status": "pending"
          }
        ],
        "review": "unknown",
        "state": "open"
      },
      {
        "id": "PR13",
        "head": "c",
        "checks": [
          {
            "sha": "c",
            "status": "success"
          }
        ],
        "review": "changes_requested",
        "state": "open"
      },
      {
        "id": "PR14",
        "state": "merged",
        "merged": true
      },
      {
        "id": "PR15",
        "head": "d",
        "draft": true,
        "checks": [
          {
            "sha": "d",
            "status": "success"
          }
        ],
        "review": "not_reviewed",
        "state": "open"
      },
      {
        "id": "PR16",
        "readable": false,
        "error": "No read permission"
      }
    ]
  }
}
Processing rules
Use snapshots only without inferring complete branch protection. Associate checks with the current head; old success does not pass a new commit. Keep CI, review, draft, conflicts and merged status separate. Unreadable is unknown, not closed.
This shows complete inputs and expected outputs. Switching tabs runs no task; verify real connections and writes separately in your environment.
BEFORE YOU START

Prepare the materials and check your tools

Start with the practice files

  • Download five snapshots and identify current heads.
  • Exercise ids are not real GitHub PRs.
  • Classify before opening reference actions.

Before using real services

  • Specify repository and PR list.
  • Verify current-head, check and review read capabilities.
  • Board writes, owner contact and CI reruns require their own scope.

Complete one file-based exercise first. For real services, verify the actual account, available tools and operation scope, then follow the acceptance check at each stage.

Download the original input and rules ↓
EXECUTION & TAKEOVER

Execution and takeover boundaries

The actions below require the agreed inputs, accounts and scope. Configuring a Routine does not expand that authorization.

Can run automatically

Read current commits, checks and reviews for specified PRs; report conflicts, draft state and merge state separately.

Requires confirmation

Confirm exact targets before changing Notion status, notifying owners, reviewing, editing code, rerunning CI or merging.

Take over after a failure

Mark mismatched SHA checks or inaccessible data as unknown. Have the user inspect the current commit, then update only records with verified changes.

STEP 01

Fix PR identity and observation time

A number needs its repository context. Real reports also need observation time and current head to explain stale results.

Stage 01 · Fix PR identity and observation time
Inventory the five uploaded records, readability, heads and missing fields. Use snapshots only; do not connect GitHub/Notion or notify owners. Save index.md.
Expected output

Five identities and gaps.

Acceptance check

PR16 remains unknown and PR14 remains merged.

STEP 02

Count only effective current-commit checks

Checks can target an old head or test merge commit. This exercise uses explicit SHA matching and does not invent protection rules.

Stage 02 · Count only effective current-commit checks
Compare head with checks.sha. Separate old checks and current checks. PR12 new-b remains pending; old-a success does not count as a current pass. List unconfirmed branch protections.
Expected output

A commit-associated check table.

Acceptance check

PR12 is not all checks passed.

STEP 03

Evaluate review, draft and merged dimensions separately

CI cannot summarize every condition. Preserve unknown review state where unavailable.

Stage 03 · Evaluate review, draft and merged dimensions separately
For each PR, list CI, review, draft, merged and readability, then a next step. Retain PR13 changes_requested and PR15 draft. Do not infer mergeable.
Expected output

Five status/action rows.

Acceptance check

PR13/PR15 do not become ready solely because CI passed.

STEP 04

Write a report and a proposed board diff

A suggested state is not an actual board write. Keep the old value and evidence so the transition can be reviewed.

Stage 04 · Write a report and a proposed board diff
Generate a report and proposed board changes with PR ids and reasons. If the old value is unavailable, say needs verification. Merged leaves active; unreadable stays unknown. Deliver files only; no board edits or messages.
Expected output

A summary and pending changes.

Acceptance check

Suggested and executed writes are clearly distinct.

STEP 05

Read current state again before a specific write

A new commit or review may arrive after the snapshot. Revalidate the exact version before updating any external record.

Stage 05 · Read current state again before a specific write
Read only <repository/PR list>. Record latest heads, checks, reviews, draft/merge states and time. If a specific Notion update is authorized, preview the diff and read it back. Do not notify agents, rerun CI, merge or push.
Expected output

A real report or access blocker.

Acceptance check

Any write uses current evidence, not an old summary.

STEP 06

Follow meaningful changes without repeat noise

Persistent unreadability is a failure state, not no change. Record state versions, new faults and recovery.

Stage 06 · Follow meaningful changes without repeat noise
Draft a pr-watch Skill with scope, heads, observed state, limits, diffs, failures and recovery. Propose a Routine only; stay quiet when unchanged. Contact requires separate authorization. Do not delegate across Bots or execute code actions.
Expected output

Rerun and notification rules.

Acceptance check

Unchanged state is not repeatedly announced; new heads trigger fresh checks.

TROUBLESHOOTING & ACCEPTANCE

Find the evidence before choosing the next action

Yesterday’s green status was reused

Check the current head and effective check identity.

Requested changes became mergeable

Keep human review separate from CI.

403 became closed

An access error means unknown, not a business state.

Can it automatically ask an agent to fix it?

Prepare evidence first and wait for explicit messaging/delegation authorization.

Check every item before finishing

These page-local checkboxes reset on refresh. Checking them does not verify a real service connection.

Checked 0 / 6 items

PRACTICE MATERIALS

Download the inputs separately from the reference answers

Start with input and rules without showing the reference answers. After acceptance, save the report and complete prompt set.

SOURCES & VERIFICATION

Check documented capabilities and exercise results separately

Content updated: · Editing a page does not reverify its sources or live workflow.

Documentation review: Reviewed within the recorded scope ·
Reviewed effective checks for current head/test-merge commits, reviews and merge state. Public reads, Notion writes and sustained monitoring require separate acceptance.

Live workflow verification: Partial verification · includes failed checks ·
Partial: Grok Bot read real public PR #3, its current-head checks and reviews; original API results were reviewed. CI, review and merged state are separate. Continuous tracking of open PRs, pagination, Notion writes, notifications and Routines remain untested; mergeable=null remains unknown.

Last execution attempt: · An attempt date does not establish a passed verification.

The PR snapshots, commit ids and reference results below are synthetic. A separate read-only run on 2026-10-18 checked public PR #3 and its current-head checks and reviews. Notion writes, notifications, continuous monitoring and Routines remain untested; see the verification record.

  1. GitHub: required status checks ↗

    Associate effective checks with the current commit; the exercise uses synthetic snapshots.

  2. GitHub: resolving reviews ↗

    Review status and automated checks are separate dimensions.

  3. Grok Bot: apps and the shared computer ↗

    Check connected accounts, available tools, visibility and user takeover.

  4. Grok Bot: Skills and Routines ↗

    Validate a manual run before saving a method or scheduling it.

NEXT STEP

Try another small batch of your own material

Retain original input and operation records. Verify that each result can be traced before adding connections or recurring runs.

217 related external resources →Official sources and original authors’ posts, each with a note on what was checked.

Last updated: