Skip to content

Adds PR review skill and checklist for pull request evaluations#7227

Draft
waldekmastykarz wants to merge 4 commits into
pnp:mainfrom
waldekmastykarz:pr-review-skill
Draft

Adds PR review skill and checklist for pull request evaluations#7227
waldekmastykarz wants to merge 4 commits into
pnp:mainfrom
waldekmastykarz:pr-review-skill

Conversation

@waldekmastykarz

Copy link
Copy Markdown
Member

No description provided.

@Jwaegebaert

Copy link
Copy Markdown
Contributor

Isn't this simular to #7193?

@waldekmastykarz

Copy link
Copy Markdown
Member Author

Yes it is. @milanholemans and I crossed streams. Like we agreed, we closed his PR in favor of this one.

@milanholemans milanholemans self-assigned this Jun 2, 2026

@milanholemans milanholemans 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.

Looks promising, would like to see this in action. Made a few remarks while reviewing the skill.

Comment thread .github/skills/pr-review/references/pr-checklist.md Outdated
- Escape user input in XML and URLs.
- Verbose and debug outputs are logged to stdErr (`logger.logToStderr` instead of `logger.log`).
- Do not do conditional output in JSON output mode; use `defaultProperties` for defining default properties.
- For commands with multiple options where the user is required to choose one, define these options using an `optionSet` without specific validation logic in the command's validate method.

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.

Option sets don't exist anymore in Zod, let's remove it and let's also remove it from the docs.

Comment thread .github/skills/pr-review/references/pr-checklist.md
Comment thread .github/skills/pr-review/references/pr-checklist.md Outdated
Comment thread .github/skills/pr-review/references/pr-checklist.md Outdated

Check test files (`.spec.ts`) for:

- Coverage of happy path and error cases.

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.

But also command name, description not being null, schema validation.

- Coverage of happy path and error cases.
- Proper use of mocks and assertions.
- Tests that actually verify behavior (not just that code runs).

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.

Let's add:

  • Use sinon.restore() in after() to reset stubs/spies.

Comment thread .github/skills/pr-review/SKILL.md

Walk through each applicable item in the checklist and verify it against the diff. Key items to check:

- **Single quotes** for strings (not double quotes).

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.

I try to maintain this for command files, but to be honest, mostly for test files, it's a hopeless task. People copy responses from API requests that contain double quotes, and it feels stupid to ask them to replace the entire response with single quotes.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I think we should still aim for some level of consistency and AI should help us to enforce that. I suggest we keep this and remove if it becomes an issue.

Comment thread .github/skills/pr-review/SKILL.md
@milanholemans milanholemans marked this pull request as draft June 7, 2026 20:53
waldekmastykarz and others added 3 commits June 11, 2026 11:14
- Remove obsolete PII/telemetry tracking rule (handled centrally by Zod)
- Replace 'All tests must pass' with 'npm test must pass without errors'
- Add Documentation Quality section (D) to SKILL.md
- Add Reference Commands section pointing to example implementations

Co-authored-by: Copilot <[email protected]>
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.

3 participants