chore(ai-workflow): track repo-managed review tooling (#1046)

* chore(ai-workflow): track repo-managed review tooling * fix(ai-workflow): remove repo-specific path assumptions Make shared workflow hooks and APK testing guidance resolve paths from the repo and contributor environment so the tooling works for all contributors, not just one machine.
2026-08-03 07:41:04 +02:00 · 2026-03-10 15:49:15 +08:00
parent 878d0ee70b
commit a92b185a66
197 changed files with 20785 additions and 3 deletions
@@ -0,0 +1,141 @@
+---
+name: review-and-merge-pr
+description: Review an open GitHub pull request, inspect feedback from Cursor Bugbot, CodeRabbit, CI, and human reviewers, decide which findings are valid, implement fixes on the PR branch, and merge the PR into master when it is ready. Use when the user says "check the PR", "address bugbot comments", "handle CodeRabbit feedback", "review PR feedback", or "merge this PR".
+---
+
+# Review And Merge Pr
+
+## Overview
+
+Use this skill after a feature branch already has an open PR into `master`.
+Stay on the PR branch, treat review bots as input rather than authority, and only merge once the branch is verified and the remaining comments are either fixed or explicitly declined with a reason.
+
+## Workflow
+
+### 1. Identify the target PR
+
+Prefer the PR for the current branch when the branch is not `master`.
+If the current branch is `master`, inspect open PRs and choose the one that matches the user request.
+If there is no open PR yet, stop and use `make-closed-issue` first.
+
+Useful commands:
+
+```bash
+gh pr status
+gh pr list --repo bitsocialnet/5chan --state open
+gh pr view <pr-number> --repo bitsocialnet/5chan --json number,title,url,headRefName,baseRefName,isDraft,reviewDecision,mergeStateStatus
+```
+
+### 2. Gather all review signals before changing code
+
+Read the PR state, checks, issue comments, review summaries, and inline review comments before deciding what to change.
+Do not merge based only on the top-level review verdict.
+
+Useful commands:
+
+```bash
+gh pr view <pr-number> --repo bitsocialnet/5chan --json number,title,url,headRefName,baseRefName,isDraft,reviewDecision,mergeStateStatus
+gh pr checks <pr-number>
+gh api "repos/bitsocialnet/5chan/issues/<pr-number>/comments?per_page=100"
+gh api "repos/bitsocialnet/5chan/pulls/<pr-number>/reviews?per_page=100"
+gh api "repos/bitsocialnet/5chan/pulls/<pr-number>/comments?per_page=100"
+```
+
+Focus on comments from:
+
+- Cursor Bugbot
+- CodeRabbit
+- human reviewers
+- failing CI checks
+
+### 3. Triage findings instead of blindly applying them
+
+Sort feedback into these buckets:
+
+- `must-fix`: correctness bugs, broken behavior, crashes, security issues, test failures, reproducible regressions
+- `should-fix`: clear maintainability or edge-case issues with concrete evidence
+- `decline`: false positives, stale comments, duplicate findings, speculative style-only suggestions, or feedback already addressed in newer commits
+
+Rules:
+
+- Never merge with unresolved `must-fix` findings.
+- Do not accept a bot finding without reading the relevant code and diff.
+- If a finding is ambiguous but high-risk, ask the user before merging.
+- If a comment is wrong or stale, explain why in the PR rather than silently ignoring it.
+
+### 4. Work on the PR branch and keep the PR updated
+
+Switch to the PR branch if needed, apply the valid fixes, and push new commits to the same branch.
+Do not open a replacement PR unless the user explicitly asks for that.
+
+Useful commands:
+
+```bash
+git switch <head-branch>
+git fetch origin <head-branch>
+git status --short --branch
+git add <files>
+git commit -m "fix(scope): address review feedback"
+git push
+```
+
+After code changes, follow repo verification rules from `AGENTS.md`:
+
+- run `yarn build`, `yarn lint`, and `yarn type-check`
+- run `yarn test` after adding or changing tests
+- run `yarn doctor` after React UI logic changes
+- use `playwright-cli` for UI/visual changes on desktop and mobile
+
+### 5. Report back on the PR before merging
+
+Summarize what was fixed and what was declined.
+Use `gh pr comment` for a concise PR update when the branch changed because of review feedback.
+
+Example:
+
+```bash
+gh pr comment <pr-number> --repo bitsocialnet/5chan --body "Addressed the valid review findings in the latest commit. Remaining bot comments are stale or not applicable for the reasons checked locally."
+```
+
+### 6. Merge only when the PR is actually ready
+
+Merge only if all of these are true:
+
+- the PR is not draft
+- required checks are passing
+- the branch is mergeable into `master`
+- no unresolved `must-fix` reviewer findings remain
+- the latest code was verified locally after the last review-driven change
+
+Preferred merge command:
+
+```bash
+gh pr merge <pr-number> --repo bitsocialnet/5chan --squash --delete-branch
+```
+
+### 7. Clean up local state after merge
+
+After the PR is merged:
+
+```bash
+git switch master
+git pull --ff-only
+git branch -D <head-branch> 2>/dev/null || true
+```
+
+If the PR branch lived in a dedicated worktree, remove that worktree after leaving it:
+
+```bash
+git worktree list
+git worktree remove /path/to/worktree
+```
+
+### 8. Report the outcome
+
+Tell the user:
+
+- which findings were fixed
+- which findings were declined and why
+- which verification commands ran
+- whether the PR was merged
+- whether the branch and any worktree were cleaned up
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Review and Merge PR"
+  short_description: "Check PR feedback, fix valid findings, and merge when ready"
+  default_prompt: "Review the current PR, address valid bot or human feedback, and merge it when ready."