Skip to content

chore(agents): add PR review feedback loop to collaborative PR review skill - #8015

Closed
reidkaufmann wants to merge 1 commit into
masterfrom
docs/pr-review-loop-skill
Closed

reidkaufmann wants to merge 1 commit into
masterfrom
docs/pr-review-loop-skill

Conversation

@reidkaufmann

Copy link
Copy Markdown
Contributor

This PR doesn't close an issue.

What changed

Adds a review-feedback reference to the collaborative PR review skill, linked from SKILL.md.
It covers waiting for Copilot to re-review after a push, replying to each review comment with the commit that addresses it, and updating those replies after a squash or rebase.
It also says to fix broken links the link checker reports in changed files, even when the PR didn't add them.

Why

On #7981, Copilot re-reviewed after each push, and two replies cited commits that a later squash removed from the branch.
The link checker also reported anchors that were broken before the PR.

Impact

Agent guidance only; no published pages change.

Verification

  • yarn build:agent:instructions and yarn validate:agent-instructions pass. The new content is in references/ because SKILL.md has a 160-line limit.
  • Prettier passes; commit hooks passed.
  • I didn't confirm whether Copilot re-reviews on every push or only some pushes, so the text says it "can".

Preview pages

None. The change is limited to .agents/.

Checklist

  • Signed the InfluxData CLA (if necessary)
  • Rebased/mergeable
  • Local build passes (npx hugo --quiet) — not run; no content or layout changes

Suggested reviewers (click to expand)

Based on files changed, consider requesting review from:

InfluxDB 3

Content Engineering Product
Core, Enterprise influxdata/monolith-team peterbarnett03, garylfowler
Clustered influxdata/platform-team ritwika314, sanderson
Cloud Dedicated influxdata/cloud-single-tenant ritwika314, sanderson
Cloud Serverless - mavarius, garylfowler
Explorer - mavarius, peterbarnett03

InfluxDB v2 / v1 / Enterprise v1

Content Engineering Product
v2, Cloud (TSM) influxdata/edge sanderson, jstirnaman
v1, Enterprise v1 influxdata/edge sanderson, jstirnaman

Other Products

Content Engineering Product
Telegraf influxdata/telegraf-team sanderson, caterryan
Kapacitor influxdata/bonitoo sanderson, jstirnaman
Chronograf influxdata/bonitoo mavarius, caterryan
Flux - sanderson, jstirnaman

Shared / Cross-Product

Content Reviewers
/content/shared/ influxdata/product-managers
API docs Relevant product team above

… skill

What changed: Add references/review-feedback.md to the collaborative-pr-review
skill and link it from SKILL.md. It covers waiting for Copilot re-reviews,
replying to review comments with the addressing commit SHA, updating replies
after a history rewrite, and fixing links the link checker reports in changed
files.

Why: Agents waited on Copilot and CI without a polling method, and replies
citing squashed commits pointed at SHAs no longer on the branch.

Impact: Agent workflow guidance only; no published content changes.

Verification: build-agent-instructions and validate-agent-instructions pass;
prettier passes.
@reidkaufmann

Copy link
Copy Markdown
Contributor Author

This is generic enough it probably doesn't belong here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant