Skip to content

docs(ai): add reviewer guideline - #1189

Open
zhijie-yang wants to merge 9 commits into
mainfrom
ROCKS-3439/ai-pr-reviewer-guideline
Open

docs(ai): add reviewer guideline#1189
zhijie-yang wants to merge 9 commits into
mainfrom
ROCKS-3439/ai-pr-reviewer-guideline

Conversation

@zhijie-yang

@zhijie-yang zhijie-yang commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator

Description

  • Adds the AGENTS.md file that provides the guideline to help AI agents review this repo, both locally and with Copilot.
  • Adds the hints in the CONTRIBUTING.md to instruct the contributor using the AI to pre-review before submitting the PR.
  • Align README.md with AGENTS.md for our current policy regarding the vulnerability managements.

Related issues

N/A

Picture of a cool rock:

@zhijie-yang
zhijie-yang requested review from alesancor1 and lczyk and a balanced review from Copilot and removed request for alesancor1 August 25, 2026 16:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Warning

Copilot couldn't run its full agentic review because it didn't start before the timeout. Make sure your repository has a runner available, or add a copilot-code-review.yml file specifying one with the runs-on attribute. See the docs for more details.

Adds an AI/human reviewer guide and updates contributor/docs guidance to reflect the repo’s current vulnerability-filtering policy (favoring ignored-vulnerabilities and deprecating .trivyignore).

Changes:

  • Added AGENTS.md with a standardized PR review checklist and local AI self-review workflow.
  • Updated README.md to document ignored-vulnerabilities and clarify .trivyignore deprecation/compatibility.
  • Updated CONTRIBUTING.md to recommend an AI-assisted self-review prior to opening PRs.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
README.md Updates vulnerability-filtering documentation and workflow input descriptions, adds .trivyignore legacy guidance.
CONTRIBUTING.md Adds a pre-PR AI self-review recommendation referencing AGENTS.md.
AGENTS.md Introduces a comprehensive agent/human PR review standard and local review procedure.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread CONTRIBUTING.md
Comment thread AGENTS.md Outdated
Comment thread README.md Outdated

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

Comment thread README.md
Comment thread README.md
Comment thread README.md
Comment thread README.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
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.

2 participants