Skip to content

Add Azure PowerShell code review skill - #30028

Draft
ZelinWang (wangzelin007) wants to merge 2 commits into
Azure:mainfrom
wangzelin007:zelinwang/add-code-review-skill
Draft

Add Azure PowerShell code review skill#30028
ZelinWang (wangzelin007) wants to merge 2 commits into
Azure:mainfrom
wangzelin007:zelinwang/add-code-review-skill

Conversation

@wangzelin007

@wangzelin007 ZelinWang (wangzelin007) commented Aug 18, 2026

Copy link
Copy Markdown
Member

🤖 PR Validation — ️✔️ All clear

Tests
️✔️ 2/2

Description

Adds a repository-level Copilot skill for reviewing Azure PowerShell pull requests.

The skill covers:

  • generated and AutoRest module triage
  • TypeSpec versus Swagger classification
  • changelog, help, test, recording, manifest, and formatting checks
  • cmdlet behavior and compatibility review
  • new-module onboarding and out-of-band release handling
  • review recommendations and comment-writing guidance

The repository version intentionally does not contain vendor lists or rules that skip reviews based on the PR author's identity.

Testing

  • Verified the skill is self-contained at .github/skills/code-review/SKILL.md.
  • Verified no vendor, CLIPS, or author-based skip rules remain.
  • Ran git diff --check.

Copilot-Session: 3732a88d-f131-4633-ac86-77dd4543f31d
Copilot AI lite review requested due to automatic review settings August 18, 2026 00:53
@azure-pipelines

Copy link
Copy Markdown
Contributor
Azure Pipelines:
Successfully started running 1 pipeline(s).
There may be pipelines that require an authorized user to comment /azp run to run.

@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Contributor
Azure Pipelines:
Successfully started running 3 pipeline(s).

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

Adds a repository-level Copilot skill (azure-powershell-code-review) intended to guide consistent Azure PowerShell PR triage and review, with emphasis on generated/AutoRest workflows, release readiness, and cmdlet correctness checks.

Changes:

  • Introduces a new code review skill document with a two-phase review workflow (triage + code review).
  • Defines generated-module identification rules (TypeSpec vs Swagger) and related required artifacts/checks.
  • Adds structured “Review Result” recommendations and comment-writing guidance.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .github/skills/code-review/SKILL.md Outdated
Comment on lines +49 to +53
1. Stop the normal ownership flow.
2. Mark the PR for handoff to the Codegen Squad for TypeSpec migration.
3. Contact Bernard Pan `<bernardpan@microsoft.com>`.
4. Do not guess a GitHub username; resolve it before assigning.
5. Resume normal review after the migration is complete.
Copilot-Session: 3732a88d-f131-4633-ac86-77dd4543f31d
Copilot AI review requested due to automatic review settings August 18, 2026 01:08

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 1 out of 1 changed files in this pull request and generated no new comments.

Suppressed comments (2)

.github/skills/code-review/SKILL.md:36

  • The skill only treats src/<ModuleName>/<SubModuleName>.Autorest/** as a generated-module indicator, but this repo also has generated AutoRest outputs under generated/<ModuleName>/<SubModuleName>.Autorest/** (e.g., generated/Compute/Compute.Autorest). Without including the generated/ pattern, triage will miss a large class of generated-module PRs.
Changes under:

```text
src/<ModuleName>/<SubModuleName>.Autorest/**

are changes to a generated module.

**.github/skills/code-review/SKILL.md:58**
* `Contributor PRs must not change generated/**` is stated as a hard rule here, but the repo’s documented contribution guidance doesn’t mention this restriction, and CI only warns about mixed `/src` + `/generated` changes (it doesn’t blanket-ban `generated/**`). Consider softening this to guidance (or linking to the authoritative policy) so reviewers don’t incorrectly block legitimate PRs.

Contributor PRs must not change generated/**, except:

  • Protected-branch merge PRs.
  • PRs titled [skip ci] Archive ....
</details>

@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Contributor
Azure Pipelines:
Successfully started running 3 pipeline(s).

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