docs(ai): Add review skill, VsCode prompts#15799
Merged
christopherco merged 1 commit intomicrosoft:tomls/base/mainfrom Feb 13, 2026
Merged
docs(ai): Add review skill, VsCode prompts#15799christopherco merged 1 commit intomicrosoft:tomls/base/mainfrom
christopherco merged 1 commit intomicrosoft:tomls/base/mainfrom
Conversation
dmcilvaney
force-pushed
the
damcilva/prd_ai_tooling_parts/phase_4
branch
5 times, most recently
from
e774011 to
4124e11
Compare
christopherco
approved these changes
Feb 13, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Adds VS Code prompt files and documentation updates to support AI-assisted workflows (prompts + skills) for Azure Linux component maintenance, aligning repo docs with the new prompt/skill structure.
Changes:
- Updates the agent instructions PRD to describe a two-tier prompt model and marks the new prompts as implemented.
- Extends
README.mdwith guidance for using VS Code prompt files and GitHub Copilot CLI in this repo. - Adds five
.github/prompts/azl-*.prompt.mdfiles for add/update/review/debug/migrate component workflows.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 16 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/prds/agent-instructions.prd.md | Documents the two-tier prompt model and tracks prompt deliverables. |
| README.md | Adds VS Code + Copilot CLI usage guidance and a prompt catalog. |
| .github/prompts/azl-add-component.prompt.md | New prompt to guide adding a component via existing skills/instructions. |
| .github/prompts/azl-update-component.prompt.md | New prompt encoding an update workflow (version/deps/overlay/config). |
| .github/prompts/azl-review-component.prompt.md | New prompt wrapping the component hygiene review skill/checklist. |
| .github/prompts/azl-debug-component.prompt.md | New prompt for triaging overlay vs build vs runtime/packaging failures. |
| .github/prompts/azl-migrate-component.prompt.md | New prompt for migrating inline component definitions to .comp.toml files. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
dmcilvaney
force-pushed
the
damcilva/prd_ai_tooling_parts/phase_4
branch
from
4124e11 to
5485d64
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| This repo includes [GitHub Copilot](https://docs.github.com/en/copilot) prompt files in `.github/` that automate common workflows. Open VS Code with Copilot Chat in **Agent mode**, attach a prompt (📎), and fill in the inputs. | ||
|
|
||
| > **Important:** VSCode works properly when opened as a workspace (i.e. open `code ~/repos/azurelinux`, NOT `code ~/repos`). Otherwise, Copilot may not find the prompt files and won't load the skills. |
There was a problem hiding this comment.
Corrected spelling of 'VSCode' to 'VS Code' for consistency with official product naming.
| > Add the cowsay package, but make it clippysay and make clippy the default | ||
| ``` | ||
|
|
||
| In VSCode, there are specialized prompts for common tasks. They can be accessed from the chat window by typing `/azl-...` to filter for Azure Linux prompts: |
There was a problem hiding this comment.
Corrected spelling of 'VSCode' to 'VS Code' for consistency with official product naming.
|
|
||
| ### Copilot CLI | ||
|
|
||
| The skills and instructions are also compatible with the [GitHub Copilot CLI](https://github.com/features/copilot/cli/) which can be used directly from the terminal without opening VSCode. |
There was a problem hiding this comment.
Corrected spelling of 'VSCode' to 'VS Code' for consistency with official product naming.
christopherco
approved these changes
Feb 13, 2026
christopherco
merged commit 7682b16
into
microsoft:tomls/base/main
10 of 12 checks passed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.