microsoft--powertoys
wehub-resource-sync
79031da543
Spell checking / Check Spelling (push) Has been cancelled
Spell checking / Update PR (push) Has been cancelled
Publish Dev Docs Website / build (push) Failing after 1s
Publish Dev Docs Website / deploy (push) Has been skipped
Spell checking / Report (Push) (push) Has been cancelled
Spell checking / Report (PR) (push) Has been cancelled
42 行
1.3 KiB
Markdown
42 行
1.3 KiB
Markdown
---
|
|
description: 'PowerToys AI contributor guidance'
|
|
---
|
|
|
|
# PowerToys – Copilot Instructions
|
|
|
|
Concise guidance for AI contributions. For complete details, see [AGENTS.md](../AGENTS.md).
|
|
|
|
## Key Rules
|
|
|
|
- Atomic PRs: one logical change, no drive-by refactors
|
|
- Add tests when changing behavior
|
|
- Keep hot paths quiet (no logging in hooks/tight loops)
|
|
|
|
## Style Enforcement
|
|
|
|
- C#: `src/.editorconfig`, StyleCop.Analyzers
|
|
- C++: `src/.clang-format`
|
|
- XAML: XamlStyler
|
|
|
|
## When to Ask for Clarification
|
|
|
|
- Ambiguous spec after scanning docs
|
|
- Cross-module impact unclear
|
|
- Security, elevation, or installer changes
|
|
|
|
## Component-Specific Instructions
|
|
|
|
These are auto-applied based on file location:
|
|
- [Runner & Settings UI](.github/instructions/runner-settings-ui.instructions.md)
|
|
- [Common Libraries](.github/instructions/common-libraries.instructions.md)
|
|
|
|
## Shortcut Guide V2 Manifests
|
|
|
|
When creating or editing Shortcut Guide keyboard shortcut manifest files, follow the schema and naming conventions in the spec:
|
|
|
|
- [WinGet Manifest Keyboard Shortcuts schema](<../doc/specs/WinGet Manifest Keyboard Shortcuts schema.md>) – manifest file format, field definitions, file naming, and the `+` prefix convention for apps without a WinGet package
|
|
|
|
## Detailed Documentation
|
|
|
|
- [Architecture](../doc/devdocs/core/architecture.md)
|
|
- [Coding Style](../doc/devdocs/development/style.md) |