Add create PR tool and skill (#8631)

* Add create PR tool and skill

* CCR comments

Author: alexr00

package.json

@@ -3800,6 +3800,9 @@
 			},
 			{
 				"path": "./src/lm/skills/address-pr-comments/SKILL.md"
+			},
+			{
+				"path": "./src/lm/skills/create-pull-request/SKILL.md"
 			}
 		],
 		"languageModelTools": [
@@ -4040,6 +4043,67 @@
 				"userDescription": "%languageModelTools.github-pull-request_openPullRequest.description%",
 				"when": "config.githubPullRequests.experimental.chat"
 			},
+			{
+				"name": "github-pull-request_create_pull_request",
+				"tags": [
+					"github",
+					"pull request"
+				],
+				"toolReferenceName": "create_pull_request",
+				"displayName": "%languageModelTools.github-pull-request_create_pull_request.displayName%",
+				"userDescription": "%languageModelTools.github-pull-request_create_pull_request.description%",
+				"modelDescription": "Create a new GitHub pull request. Requires a title and head branch. The base branch and repo default to the repository defaults. Returns the created pull request number, URL, and details.",
+				"icon": "$(git-pull-request-new)",
+				"canBeReferencedInPrompt": true,
+				"inputSchema": {
+					"type": "object",
+					"properties": {
+						"repo": {
+							"type": "object",
+							"description": "The repository to create the pull request in.",
+							"properties": {
+								"owner": {
+									"type": "string",
+									"description": "The owner of the repository."
+								},
+								"name": {
+									"type": "string",
+									"description": "The name of the repository."
+								}
+							}
+						},
+						"title": {
+							"type": "string",
+							"description": "The title of the pull request."
+						},
+						"body": {
+							"type": "string",
+							"description": "The body/description of the pull request."
+						},
+						"head": {
+							"type": "string",
+							"description": "The name of the branch where your changes are implemented (branch name only, without owner prefix)."
+						},
+						"headOwner": {
+							"type": "string",
+							"description": "The owner of the head branch repository. Defaults to the origin/push remote repository owner."
+						},
+						"base": {
+							"type": "string",
+							"description": "The name of the branch you want the changes pulled into. Defaults to the repository's default branch."
+						},
+						"draft": {
+							"type": "boolean",
+							"description": "Indicates whether the pull request is a draft."
+						}
+					},
+					"required": [
+						"title",
+						"head"
+					]
+				},
+				"when": "config.githubPullRequests.experimental.chat"
+			},
 			{
 				"name": "github-pull-request_resolveReviewThread",
 				"tags": [

package.nls.json

@@ -447,5 +447,7 @@
 	"languageModelTools.github-pull-request_openPullRequest.displayName": "Open Pull Request",
 	"languageModelTools.github-pull-request_openPullRequest.description": "Get information about the open GitHub pull request. This information includes: comments, files changed, pull request title + description, and pull request state.",
 	"languageModelTools.github-pull-request_resolveReviewThread.displayName": "Resolve Review Thread",
-	"languageModelTools.github-pull-request_resolveReviewThread.description": "Resolve a review thread on the active GitHub pull request."
+	"languageModelTools.github-pull-request_resolveReviewThread.description": "Resolve a review thread on the active GitHub pull request.",
+	"languageModelTools.github-pull-request_create_pull_request.displayName": "Create a GitHub pull request",
+	"languageModelTools.github-pull-request_create_pull_request.description": "Create a new GitHub pull request with a title, head branch, and optional body, base branch, and draft flag."
 }

src/lm/skills/create-pull-request/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: create-pull-request
+description: "Create a GitHub Pull Request from the current or specified branch. Use when: opening a PR, submitting code for review, creating a draft PR, publishing a branch as a pull request, proposing changes to a repository."
+argument-hint: "Optionally specify a title, base branch, or whether to create as a draft"
+---
+
+# Create a GitHub Pull Request
+
+Gather the necessary information, prepare a clear title and description, then call the tool to open the pull request.
+
+## When to Use
+
+- The user wants to open a PR for their current or a specified branch
+- The user has finished a feature or fix and wants to submit it for review
+- The user wants to create a draft PR to share work in progress
+- The user asks to "open a PR", "create a pull request", or "submit for review"
+
+## Procedure
+
+### 1. Gather Information
+
+Determine the required parameters before calling the tool:
+
+- **Head branch**: If the user has not specified a branch, use workspace or git context to find the current branch name. Do not use `owner:branch` format - pass just the branch name (e.g. `my-feature`).
+- **Base branch**: If the user has not specified a base branch, omit it and let the tool use the repository's default branch.
+- **Title**: If the user has not provided a title, derive one from the branch name, recent commits, or the user's description of their work (see Best Practices below).
+- **Body**: If the user has not provided a description, prepare a concise summary of what changed and why (see Best Practices below).
+- **Draft**: Ask or infer whether the PR should be a draft. Default to non-draft unless the user indicates the work is not ready for review.
+
+### 2. Check for Uncommitted or Unpushed Changes
+
+Before creating the PR, inspect the working tree state. If you need to run git commands, give an explanation for why the command needs to be run.
+
+1. **Check for uncommitted changes**: Use the git tool or VS Code SCM context to determine whether there are staged or unstaged file changes. If yes:
+	 - Ask the user if they want to commit these changes before opening the PR.
+	 - If they do, help them write a commit message and commit the changes (`git add -A && git commit -m "<message>"`).
+	 - If they decline, proceed only if there are already commits on the branch that are ahead of the base - otherwise there is nothing to put in the PR.
+
+2. **Check for unpushed commits**: Determine whether the local branch has commits that have not been pushed to the remote (i.e. the branch is ahead of its upstream). If yes:
+	 - Ask the user if they want to push before opening the PR, or let them know the tool will attempt to push automatically if needed.
+	 - If pushing manually is preferred, run `git push` (or `git push --set-upstream origin <branch>` if no upstream is set yet) before calling the tool.
+
+3. **Confirm the branch is on the remote**: The `create_pull_request` tool requires the head branch to be present on the remote. If it is not, push it first.
+
+If all changes are already committed and pushed, proceed directly to the next step.
+
+### 3. Prepare PR Details
+
+Write a good title and description if the user has not provided them:
+
+**Title**: Use imperative mood, keep it under 72 characters, and describe *what* the PR does (e.g. `Add retry logic for failed API requests`).
+
+**Body**: Include:
+- A short summary of what changed and why
+- Any relevant issue references (e.g. `Fixes #123`)
+- Notable implementation decisions, if useful for the reviewer
+
+### 4. Call the Tool
+
+Use the `github-pull-request_create_pull_request` tool with the gathered parameters:
+
+```
+github-pull-request_create_pull_request({
+	title: '<descriptive title>',
+	head: '<branch-name>',        // branch name only, not owner:branch
+	body: '<description>',        // optional but recommended
+	base: '<base-branch>',        // optional; omit to use repo default
+	draft: false,                 // set true for work-in-progress
+	headOwner: '<owner>',         // optional; omit if same as repo owner
+	repo: { owner: '<owner>', name: '<repo>' }  // optional
+})
+```
+
+### 5. Confirm Result
+
+After the tool returns successfully:
+
+- Report the PR number and URL to the user as a markdown link. The link should be a VS Code URI like `vscode-insiders://github.vscode-pull-request-github/open-pull-request-webview?uri=https://github.com/microsoft/vscode-css-languageservice/pull/460` or `vscode://github.vscode-pull-request-github/open-pull-request-webview?uri=https://github.com/microsoft/vscode-css-languageservice/pull/460`.
+- Mention the base branch the PR targets.
+- If the PR was created as a draft, remind the user to mark it ready for review when appropriate.
+
+## Best Practices
+
+### Titles
+- Use the imperative mood: `Fix`, `Add`, `Update`, `Remove`, `Refactor` - not `Fixed`, `Adding`, etc.
+- Be specific: `Fix null pointer in user login flow` beats `Fix bug`.
+- Keep it under 72 characters so it displays cleanly in GitHub and email notifications.
+
+### Descriptions
+- Start with a one-sentence summary.
+- Explain *why* the change is needed, not just *what* it does - reviewers benefit from context.
+- Reference related issues with `Fixes #<number>` or `Closes #<number>` to auto-close them on merge.
+- If the change is large, add a brief list of the main files or components touched.
+
+### Draft PRs
+- Use `draft: true` when the code is not yet ready for formal review (e.g. work in progress, awaiting feedback on approach, CI not yet passing).
+- Draft PRs are visible to collaborators but will not show as review-requested until marked ready.
+- Suggest using a draft when the user mentions they are still working on it or just want early feedback.

src/lm/tools/createPullRequestTool.ts

@@ -0,0 +1,104 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+'use strict';
+
+import * as vscode from 'vscode';
+import { RepoToolBase } from './toolsUtils';
+import { CredentialStore } from '../../github/credentials';
+import { FolderRepositoryManager } from '../../github/folderRepositoryManager';
+import { RepositoriesManager } from '../../github/repositoriesManager';
+
+interface CreatePullRequestToolParameters {
+	title: string;
+	body?: string;
+	head: string;
+	headOwner?: string;
+	base?: string;
+	draft?: boolean;
+	repo?: {
+		owner?: string;
+		name?: string;
+	};
+}
+
+interface ResolvedPullRequestParams {
+	owner: string;
+	name: string;
+	head: string;
+	base: string;
+	folderManager: FolderRepositoryManager;
+}
+
+export class CreatePullRequestTool extends RepoToolBase<CreatePullRequestToolParameters> {
+	public static readonly toolId = 'github-pull-request_create_pull_request';
+
+	constructor(credentialStore: CredentialStore, repositoriesManager: RepositoriesManager) {
+		super(credentialStore, repositoriesManager);
+	}
+
+	private async resolveParams(input: CreatePullRequestToolParameters): Promise<ResolvedPullRequestParams> {
+		const { owner, name, folderManager } = await this.getRepoInfo({ owner: input.repo?.owner, name: input.repo?.name });
+		const defaults = await folderManager.getPullRequestDefaults();
+		const headOwner = input.headOwner ?? defaults.owner;
+		const head = `${headOwner}:${input.head}`;
+		const base = input.base ?? defaults.base;
+		return { owner, name, head, base, folderManager };
+	}
+
+	async invoke(options: vscode.LanguageModelToolInvocationOptions<CreatePullRequestToolParameters>, _token: vscode.CancellationToken): Promise<vscode.LanguageModelToolResult> {
+		const { owner, name, head, base, folderManager } = await this.resolveParams(options.input);
+
+		const result = await folderManager.createPullRequest({
+			owner,
+			repo: name,
+			title: options.input.title,
+			body: options.input.body,
+			head,
+			base,
+			draft: options.input.draft,
+		});
+
+		if (!result) {
+			return new vscode.LanguageModelToolResult([new vscode.LanguageModelTextPart('Failed to create the pull request.')]);
+		}
+
+		const prInfo = {
+			number: result.number,
+			title: result.title,
+			body: result.body,
+			url: result.html_url,
+			isDraft: result.isDraft,
+			state: result.state,
+			base: result.base?.ref,
+			head: result.head?.ref,
+		};
+
+		return new vscode.LanguageModelToolResult([new vscode.LanguageModelTextPart(JSON.stringify(prInfo))]);
+	}
+
+	async prepareInvocation(options: vscode.LanguageModelToolInvocationPrepareOptions<CreatePullRequestToolParameters>): Promise<vscode.PreparedToolInvocation> {
+		const resolved = await this.resolveParams(options.input);
+		const { owner, name, base } = resolved;
+		// resolved.head is "owner:branch"; extract just the branch part for display
+		const headBranch = resolved.head.slice(resolved.head.indexOf(':') + 1);
+
+		const repoLabel = `${owner}/${name}`;
+		const message = new vscode.MarkdownString();
+		message.appendMarkdown(`**Title:** ${options.input.title}\n\n`);
+		if (options.input.body) {
+			message.appendMarkdown(`**Description:** ${options.input.body}\n\n`);
+		}
+		message.appendMarkdown(`**Branch:** \`${headBranch}\` → \`${base}\`\n\n`);
+		message.appendMarkdown(`**Repository:** ${repoLabel}\n\n`);
+
+		return {
+			invocationMessage: vscode.l10n.t('Creating pull request'),
+			confirmationMessages: {
+				title: vscode.l10n.t('Create Pull Request'),
+				message,
+			},
+		};
+	}
+}

src/lm/tools/tools.ts

@@ -6,6 +6,7 @@
 
 import * as vscode from 'vscode';
 import { ActivePullRequestTool } from './activePullRequestTool';
+import { CreatePullRequestTool } from './createPullRequestTool';
 import { FetchIssueTool } from './fetchIssueTool';
 import { FetchLabelsTool } from './fetchLabelsTool';
 import { FetchNotificationTool } from './fetchNotificationTool';
@@ -22,6 +23,7 @@ export function registerTools(context: vscode.ExtensionContext, credentialStore:
 	context.subscriptions.push(vscode.lm.registerTool(ActivePullRequestTool.toolId, new ActivePullRequestTool(repositoriesManager)));
 	context.subscriptions.push(vscode.lm.registerTool(OpenPullRequestTool.toolId, new OpenPullRequestTool(repositoriesManager)));
 	context.subscriptions.push(vscode.lm.registerTool(PullRequestStatusChecksTool.toolId, new PullRequestStatusChecksTool(credentialStore, repositoriesManager)));
+	context.subscriptions.push(vscode.lm.registerTool(CreatePullRequestTool.toolId, new CreatePullRequestTool(credentialStore, repositoriesManager)));
 	context.subscriptions.push(vscode.lm.registerTool(ResolveReviewThreadTool.toolId, new ResolveReviewThreadTool(repositoriesManager)));
 }