agent-sync-action: Skill for Claude Code

CI Watch

Monitor a pull request through the delayed-review window and act on valid feedback instead of merely reporting it.

Workflow

1. Resolve the pull request from an explicit number or URL, or from the current branch and repository. If the current branch is the repository default branch and changes are needed, create a new work branch before editing; after making and verifying changes, commit, push, create a PR if one does not already exist for that branch, then poll CI for that PR. If the current non-default branch has no PR, inspect open PRs and local branch relationships; ask only if multiple candidates remain plausible.
2. Record a baseline containing the head SHA, review submissions, conversation comments, inline review threads, resolution state, and latest finding timestamp. Prefer thread-aware GitHub reads so duplicate, outdated, and resolved findings are distinguishable.
3. Check and investigate existing review threads, comments, and issue/PR conversation items as part of the baseline, not only new findings. Classify each unresolved or recently-updated item as legitimate, duplicate, already fixed, stale/outdated, ambiguous, or incorrect before deciding whether the watch can be quiet.
4. Start a 15-minute quiet timer from the most recent finding, from the latest baseline item that still needs investigation, or from the baseline check when no findings exist.
5. Poll every 30–60 seconds while checks are pending, failing, or review threads remain unresolved. If all GitHub checks are green and all review findings are resolved or outdated, treat the PR as merge-ready and stop the watch loop immediately; do not do extra quiet-window polling or a final boundary poll.
6. On every existing, new, or updated finding:
   • Reset the quiet timer.
   • Read the cited code and relevant surrounding behavior.
   • Classify it as legitimate, duplicate, already fixed, stale/outdated, ambiguous, or incorrect.
   • Fix legitimate issues with the smallest behaviorally complete change.
   • Run focused checks proportional to the change.
   • Commit and push verified fixes to the PR branch promptly. Re-read remote state before pushing if the branch changed concurrently.
   • Resolve review threads that are fixed, stale/outdated, duplicates, false positives, not applicable, or otherwise incorrect; leave ambiguous or still-actionable threads unresolved.
7. After every push, restart the 15-minute quiet timer from the push time and continue polling because new automated reviews may target the new commit.
8. Stop the watch loop when the PR is ready to merge: either all available code-review bots approve or report no findings, or the only remaining review items are unactionable, false positives, stale/outdated, or otherwise incorrect and GitHub checks are green. For cleanup-only feedback, apply the counted-review-round completion rule:
   • A round counts only after every review/check for its head finishes, or after the full 15-minute quiet window expires and a boundary poll captures all findings available at that time. Never count a still-pending review before that boundary.
   • Stop after two consecutive counted review rounds (three at most) contain only code-simplification suggestions and no correctness bugs. Do not keep pushing cleanup solely to trigger another review round.
   • Fully investigate every finding in the final counted round and fix every legitimate one. If any correctness bug appears, reset the cleanup-only streak and review the resulting head under this rule.
   • Use the 15-minute quiet window only while checks/reviews are still not fully settled; do not apply it after the PR is green and merge-ready.
9. After the watch loop stops in a merge-ready state, run the repo-local code-simplifier/code-simplify pass across the PR diff. Investigate and fix legitimate simplification or maintainability issues it finds, preserve unrelated changes, run focused checks, then commit and push any verified fixes.
10. After the post-watch code-simplifier push, perform one final CI/review poll for the updated PR head. Apply the counted-review-round completion rule from step 8: a pending bot review is not a final result, so keep polling until it finishes or the full 15-minute quiet window expires and a boundary poll completes. Address legitimate new failures or findings with the same rules above; if no changes were made by the code-simplifier pass, do the final poll against the existing head.