doc-review: replace @github-copilot comment with GitHub Check Run for visual review

[Copilot]

The copilot-visual-review job posted a PR comment mentioning @github-copilot, which never invokes Copilot Vision and produces no entry in the Checks tab—a silent no-op that implied review was happening when it wasn't.

Changes

doc-review.yml — Job 3 (copilot-visual-review)

• Drop pull-requests: write; add checks: write
• Create an in_progress check run via checks.create at job start (immediately visible in Checks tab)
• On preview available: complete with conclusion: neutral, output contains linked page list + full checklist from .github/prompts/copilot-visual-review.md
• On timeout: complete with conclusion: neutral and re-run instructions
• Remove all PR comment logic (including the @github-copilot mention)

doc-review.yml — Job 4 (report-skipped)

• Drop pull-requests: write; add checks: write
• Replace PR comment with checks.create at conclusion: skipped, explaining why no pages were reviewed

DOC-REVIEW-PIPELINE-PLAN.md / LABEL_GUIDE.md

• Update section 2.4, 2.6, Q1 decision record, ASCII diagram, and pipeline step descriptions to reflect check-run-based approach

# Before: job posted a PR comment (no Checks entry, no Copilot action triggered)
- name: Post visual review request
  uses: actions/github-script@...
  with:
    script: |
      # ... upserts comment body containing @github-copilot mention

# After: creates an explicit Check Run visible in the Checks tab
- name: Create in-progress check run
  id: create-check
  uses: actions/github-script@...
  with:
    script: |
      const { data: check } = await github.rest.checks.create({
        name: 'Visual Review',
        head_sha: process.env.HEAD_SHA,
        status: 'in_progress',
        ...
      });

- name: Complete check run — preview available
  uses: actions/github-script@...
  with:
    script: |
      await github.rest.checks.update({
        check_run_id: checkRunId,
        status: 'completed',
        conclusion: 'neutral',   // awaiting human review
        output: { title, summary, text: pageList + checklist },
      });

Original prompt

Pull request: #6938

revert the merge of this PR from #6985 and reopen this PR for the additional tasks:

Here’s what the workflow in PR #6895 is doing and why you see the prompt but no Copilot action or Check:

1. Why the visual review prompt appears but Copilot doesn’t run

• Job 3 (copilot-visual-review) only posts a templated comment tagging @github-copilot after it finds preview URLs and confirms the preview site is live. It never invokes any Copilot API or agent run; it just writes a comment with the checklist. citecall_iAf9D7LOH37rNqKxc80uPSM8
• Unlike the code-review job (which requests the copilot-pull-request-reviewer as a reviewer), there is no equivalent trigger for a “visual review” agent. Mentions alone don’t cause Copilot Vision to execute, so Copilot doesn’t perform any work beyond the comment being posted. citecall_iAf9D7LOH37rNqKxc80uPSM8

2. Why it isn’t listed under Checks

• The workflow doesn’t create a separate check run for visual review. The job uses actions/github-script to post/update an issue comment; it doesn’t register a GitHub Check, so nothing new appears in the Checks tab. citecall_iAf9D7LOH37rNqKxc80uPSM8
• Only jobs that produce check runs (e.g., test/build steps) or the Copilot code-review ruleset show up as Checks. The visual-review comment is outside that mechanism, so it lives solely as a PR comment.

Redesign the workflow.
To perform the visual review and show status in Checks, you’d need a step that calls a Copilot Vision-capable action or service (or a GitHub App that reports a check run) instead of just posting the comment.

---

💬 Send tasks to Copilot coding agent from Slack and Teams to turn conversations into code. Copilot posts an update in your thread when it's finished.