sweeper-fix

Implement narrow VS Code issue fixes from sweeper review specs and open draft pull requests.

190k|41.9k|Updated Sep 3, 2015
One-click install
npx skills add https://github.com/microsoft/vscode --skill sweeper-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sweeper-fix
Source: https://github.com/microsoft/vscode/tree/main/.github/skills/sweeper-fix
Command: npx skills add https://github.com/microsoft/vscode --skill sweeper-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually translating a VS Code Sweeper review record into a minimal, tested code change and a draft PR is repetitive and error-prone, especially when the maintainer must guard against stale reviews, security issues, and duplicate work.

Core Features & Use Cases

  • Review Record Fetching: Retrieves the sweeper's agent-fixable review record from the public vscodesweeper-state repository for a given issue number.
  • Live State Gating: Validates the issue is still open, lacks a security label, has no existing open PR, and checks for staleness against live GitHub state before any code changes.
  • Spec-Driven Implementation: Implements the narrowest correct change anchored on the review's Likely files, Fix prompt, and Validation, adding a runnable test that fails before and passes after the fix.
  • Draft PR Creation: Pushes a branch to microsoft/vscode and opens a draft PR with a structured body referencing the issue and the sweeper record, leaving the maintainer in control of the ready-for-review flip.

Quick Start

Use the sweeper-fix skill to implement the reviewed fix for issue 12345 in the current microsoft/vscode checkout and open a draft PR.

Frequently Asked Questions about sweeper-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement a sweeper-reviewed fix for a VS Code issue?

Run the sweeper-fix skill from a clean microsoft/vscode checkout with gh CLI authenticated. The skill fetches the review record, validates live issue state, implements the narrow fix with a test, and opens a draft PR after you approve the diff.

What is the VS Code Sweeper and how does it relate to issue fixes?

The VS Code Sweeper reviews microsoft/vscode issues and writes fix specs for those judged agent-fixable. The sweeper-fix skill consumes those public specs from the egamma/vscodesweeper-state repository and turns them into tested draft pull requests.

Does sweeper-fix work on issues without a sweeper review record?

No. The skill only applies when a record exists in vscodesweeper-state with autoFixable: true. If no record is found, the skill stops and you should fix the issue directly using normal tools.

Why does sweeper-fix refuse to push when the issue has a security label?

Issues labeled security must not be fixed via a public PR because the diff would disclose the vulnerability. The skill hard-stops on the security label regardless of the review record's contents.

Can sweeper-fix open a ready-for-review PR automatically?

No. The skill always opens a draft PR and stops there. The maintainer reviews the diff, runs the validation test, and flips the PR to ready-for-review manually.

When should I not use sweeper-fix for a VS Code issue?

Skip sweeper-fix for plain fix requests that do not mention the sweeper, for issues lacking a review record, for closed issues, or for any change that would require broad refactoring beyond the review's Likely files.