Add skill-started + skill-completed PR comments for workflow_dispatch

claude-code-action@v1 rejects track_progress: true on
workflow_dispatch events, so manual retries and bootstrap
dispatches leave no real-time signal on the PR that the skill is
running -- reviewers had to hunt through the Actions tab to see
progress. On pull_request runs the action posts its own tracking
comment, so this gap only affects workflow_dispatch.

Two workflow_dispatch-only comments:

- Before skill_gen: a "Claude Opus is generating docs updates for
  <project> <tag>. Follow progress: <run URL>" placeholder. Static
  but enough to signal "yes it started".

- After Augment PR body: a run summary with skill_gen /
  skill_review / autofix conclusions and a link to the run for
  the Claude Code Report. Runs even if earlier steps failed so
  reviewers can see which step died.

Both are gated on `github.event_name == 'workflow_dispatch'` to
avoid duplicating the action's own tracking on Renovate-opened PRs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: rdimitrov

.github/workflows/upstream-release-docs.yml

@@ -481,6 +481,28 @@ jobs:
           ")
           echo "docs_paths=$HINTS" >> "$GITHUB_OUTPUT"
 
+      # claude-code-action@v1 rejects track_progress: true on
+      # workflow_dispatch events with "track_progress is only
+      # supported for events: pull_request, issue_comment, ...".
+      # That means on manual retries and bootstrap dispatches, the
+      # PR gets no real-time "Claude is working on it" comment from
+      # the action -- a reviewer watching the PR has no visible
+      # signal that the skill is actually running. Post a static
+      # placeholder comment ourselves, scoped to workflow_dispatch
+      # runs so we don't duplicate the action's own tracking on
+      # normal Renovate-opened PRs.
+      - name: Post skill-started comment (workflow_dispatch only)
+        if: github.event_name == 'workflow_dispatch' && steps.eff.outputs.number != ''
+        env:
+          PR_NUMBER: ${{ steps.eff.outputs.number }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          PROJECT_ID: ${{ steps.detect.outputs.id }}
+          NEW_TAG: ${{ steps.detect.outputs.new_tag }}
+        run: |
+          gh pr comment "$PR_NUMBER" --body "Claude Opus is generating docs updates for \`$PROJECT_ID\` \`$NEW_TAG\`. Follow progress in the workflow run: $RUN_URL
+
+          (This comment replaces the real-time tracking comment claude-code-action posts on Renovate-opened PRs, which isn't supported on \`workflow_dispatch\` events.)"
+
       # Invocation 1: generation. Runs /upstream-release-docs end-to-
       # end (all 6 phases, including the skill's own internal
       # docs-review in Phase 5). Uses Opus 4.7 — generation benefits
@@ -907,6 +929,35 @@ jobs:
 
           gh pr edit "$PR_NUMBER" --body-file /tmp/pr-body.md
 
+      # Post-run summary for workflow_dispatch, mirroring the pre-run
+      # placeholder comment above. Gives reviewers a single point in
+      # the PR timeline that says "here's what happened, and where to
+      # see the full report" without them having to hunt through the
+      # Actions tab. Skipped on pull_request runs where claude-code-
+      # action already posts its own completion comment.
+      - name: Post skill-completed summary (workflow_dispatch only)
+        if: always() && github.event_name == 'workflow_dispatch' && steps.eff.outputs.number != ''
+        env:
+          PR_NUMBER: ${{ steps.eff.outputs.number }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          PROJECT_ID: ${{ steps.detect.outputs.id }}
+          NEW_TAG: ${{ steps.detect.outputs.new_tag }}
+          GEN_CONCLUSION: ${{ steps.skill_gen.conclusion }}
+          REVIEW_CONCLUSION: ${{ steps.skill_review.conclusion }}
+          AUTOFIX_CONCLUSION: ${{ steps.autofix.conclusion }}
+        run: |
+          gh pr comment "$PR_NUMBER" --body "## Upstream-release-docs run summary
+
+          Project: \`$PROJECT_ID\` at tag \`$NEW_TAG\`
+
+          | Step | Conclusion |
+          | --- | --- |
+          | Generation (\`skill_gen\`) | \`${GEN_CONCLUSION:-(not run)}\` |
+          | Editorial review (\`skill_review\`) | \`${REVIEW_CONCLUSION:-(not run)}\` |
+          | Autofix (prettier/eslint) | \`${AUTOFIX_CONCLUSION:-(not run)}\` |
+
+          Full report and Claude's step-by-step log: $RUN_URL" || true
+
       - name: Comment on augmentation failure
         # Runs only when a preceding step failed. Comments a retry
         # pointer on the PR so a human can see the run URL.