(feat): Enhancements to Spec Kit #986

localden · 2025-10-21T17:28:23Z

Description

Introduces a smoother hand-off between stages when used with GitHub Copilot in Visual Studio Code. Prompts are now effectively "shortcuts" for chat modes, and chat modes can then hand-off to specific post-production steps.
Adds support for the version command. (specify --version flag not supported, returns error #486)
Fixes Potential bug with the create-new-feature.ps1 script that ignores existing feature branches when determining next feature number #975
Fixes Add graceful fallback and logging for GitHub API rate-limiting during template fetch #970

Screenshots

Hand-offs

Version

References

Behavior notes

There is an unexpected behavior when hand-off occurs, resetting to Agent Mode. This will be fixed by the VS Code team.

crisweber2600

🔥🔥🔥

…into localden/vscode

Co-authored-by: Copilot <[email protected]>

…n permissions Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

Sync changes

Co-authored-by: Copilot <[email protected]>

…into localden/vscode

Copilot

Pull Request Overview

Copilot reviewed 19 out of 19 changed files in this pull request and generated 2 comments.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

src/specify_cli/__init__.py

templates/commands/taskstoissues.md

Copilot · 2025-10-22T03:26:23Z

@localden I've opened a new pull request, #1004, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot

Pull Request Overview

Copilot reviewed 21 out of 21 changed files in this pull request and generated 3 comments.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-10-22T20:18:17Z

src/specify_cli/__init__.py

+            import tomllib
+            pyproject_path = Path(__file__).parent.parent.parent / "pyproject.toml"
+            if pyproject_path.exists():
+                with open(pyproject_path, "rb") as f:
+                    data = tomllib.load(f)
+                    cli_version = data.get("project", {}).get("version", "unknown")


tomllib is only available in Python 3.11+. While the project requires Python >=3.11 according to pyproject.toml, the import should be wrapped in a try-except block since it's already inside an exception handler and a fallback version of "unknown" is acceptable.

Suggested change

import tomllib

pyproject_path = Path(__file__).parent.parent.parent / "pyproject.toml"

if pyproject_path.exists():

with open(pyproject_path, "rb") as f:

data = tomllib.load(f)

cli_version = data.get("project", {}).get("version", "unknown")

try:

import tomllib

except ImportError:

# tomllib not available, fallback to "unknown"

pass

else:

pyproject_path = Path(__file__).parent.parent.parent / "pyproject.toml"

if pyproject_path.exists():

with open(pyproject_path, "rb") as f:

data = tomllib.load(f)

cli_version = data.get("project", {}).get("version", "unknown")

Copilot · 2025-10-22T20:18:18Z

src/specify_cli/__init__.py

+    info_table.add_row("Template Version", template_version)
+    info_table.add_row("Released", release_date)
+    info_table.add_row("", "")
+    info_table.add_row("Python", f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}")


[nitpick] The version string could be simplified using platform.python_version() which returns the same information in a cleaner way.

Suggested change

info_table.add_row("Python", f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}")

info_table.add_row("Python", platform.python_version())

Copilot · 2025-10-22T20:18:18Z

scripts/powershell/create-new-feature.ps1

+    $branches = git branch -a 2>$null
+    if ($LASTEXITCODE -eq 0) {
+        foreach ($branch in $branches) {
+            # Clean branch name: remove leading markers and remote prefixes


[nitpick] The regex pattern could be made more readable with a comment explaining that it removes Git's current branch marker (*), whitespace, and remote prefixes (e.g., 'remotes/origin/').

Suggested change

# Clean branch name: remove leading markers and remote prefixes

# Clean branch name: remove leading markers and remote prefixes

# The following regex removes:

# - Git's current branch marker ('*') and leading whitespace (e.g., '* main')

# - Remote prefixes (e.g., 'remotes/origin/')

N0SAFE · 2025-10-23T12:34:30Z

in vscode insiders i have a warning saying "Chat modes have been renamed to agents. Please move this file to .github/agents/speckit.[prompt].agent.md". should you not put this inside the new designated folder and file from vscode ?

mfsbo · 2025-10-26T18:55:25Z

I recommend that chatmodes, prompts should be named with prompt name first and .speckit after. So instead of speckit.plan it will be better to save as plan.speckit.prompt.md or plan.speckit.chatmode.md
This would be easy on eye and search to find plans and chat modes.

artk42 · 2025-10-29T22:07:35Z

Hey guys, just two linting errors to fix pls. Seems the spec-it popularity is driving crazy release api rate limits and it's almost impossible to use specify init, it always fails with API rate limit exceeded 403 for https://api.github.com/repos/github/spec-kit/releases/latest Initialization failed: 1

anchildress1 · 2025-10-31T02:27:07Z

I was just going to say the same thing @Nosafe did 😆 They've officially moved from .github/chatmodes/*.chatmode.md to .github/agents/*.agent.md. At this point it's pretty much a rename lift and shift, though.

anchildress1 · 2025-10-31T02:29:34Z

.github/workflows/scripts/create-release-packages.sh

+    # Create prompt file with agent frontmatter
+    cat > "$prompt_file" <<EOF
+---
+agent: ${basename}


I didn't see any tools loaded anywhere—has this given you issues before? Every single time I forget to set a tool back in one of these agent files, it seems to stop everything... but as frequently as they're changing things, I've stopped trying to guess. 😆 Just calling out as something to verify before you merge.

anchildress1 · 2025-10-31T02:50:02Z

templates/commands/taskstoissues.md

+
+1. For each task in the list, use the GitHub MCP server to create a new issue in the repository that is representative of the Git remote.
+
+**UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL**


Just a thought: Do you think it would be worth it to hard-code these checks in and not even load the prompt if the repo doesn't match? It's really more of a longer-term solution but might be worth a discussion. I'm not sure what that would even look like, tbh, but maybe worth a discussion at some point 🤷🏻‍♀️

Use VS Code handoffs

15a5630

Copilot AI review requested due to automatic review settings October 21, 2025 17:28

This comment was marked as outdated.

Sign in to view

localden added 2 commits October 21, 2025 10:35

Testing hand-offs

c59be99

Update with prompt

8e9d25e

Copilot AI review requested due to automatic review settings October 21, 2025 17:39

This comment was marked as outdated.

Sign in to view

localden added 2 commits October 21, 2025 10:48

Update prompts

317ae4d

Let's switch to proper prompts

dbd1437

Copilot AI review requested due to automatic review settings October 21, 2025 20:17

This comment was marked as outdated.

Sign in to view

Chatmodes are back in vogue

14a574a

crisweber2600 reviewed Oct 21, 2025

View reviewed changes

Hand offs with prompts

37e87c7

Copilot AI review requested due to automatic review settings October 21, 2025 21:34

This comment was marked as outdated.

Sign in to view

Prompt updates

115b433

localden self-assigned this Oct 21, 2025

localden added enhancement templates Related to template definition and not the CLI. labels Oct 21, 2025

Merge branch 'main' into localden/vscode

0ac76c8

Copilot AI review requested due to automatic review settings October 21, 2025 22:06

This comment was marked as outdated.

Sign in to view

localden added 3 commits October 21, 2025 15:12

Lint fixes

9786e58

Merge branch 'localden/vscode' of https://github.com/github/spec-kit …

65f8787

…into localden/vscode

Exclude generated releases

d4d3139

Copilot AI review requested due to automatic review settings October 21, 2025 22:21

This comment was marked as outdated.

Sign in to view

This was referenced Oct 21, 2025

feat: support check env version command for better support issue and understand using version. #907

Closed

fix: add version command to Specify CLI #811 #869

Closed

This comment was marked as outdated.

Sign in to view

Update src/specify_cli/__init__.py

d550634

Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 21, 2025 23:32

This comment was marked as outdated.

Sign in to view

localden mentioned this pull request Oct 21, 2025

Add Spec-kit to VS Code as VS Code Extension #59

Closed

psmman mentioned this pull request Oct 21, 2025

Add graceful fallback and logging for GitHub API rate-limiting during template fetch #970

Open

localden and others added 2 commits October 21, 2025 16:56

Potential fix for code scanning alert no. 3: Workflow does not contai…

7522eb3

…n permissions Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

Merge pull request #1003 from github/main

ba861cd

Sync changes

Copilot AI review requested due to automatic review settings October 22, 2025 02:36

This comment was marked as outdated.

Sign in to view

localden and others added 2 commits October 21, 2025 19:37

Update CONTRIBUTING.md

177dcad

Update src/specify_cli/__init__.py

779e1f8

Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 22, 2025 02:38

This comment was marked as outdated.

Sign in to view

localden added 3 commits October 21, 2025 20:09

Create taskstoissues.md

5f1fc6b

Merge branch 'localden/vscode' of https://github.com/github/spec-kit …

0927443

…into localden/vscode

Update taskstoissues.md

dafab39

Copilot AI review requested due to automatic review settings October 22, 2025 03:10

Copilot AI reviewed Oct 22, 2025

View reviewed changes

src/specify_cli/__init__.py Show resolved Hide resolved

templates/commands/taskstoissues.md Show resolved Hide resolved

Copilot AI mentioned this pull request Oct 22, 2025

[WIP] Address feedback from review on Spec Kit enhancements #1004

Closed

4 tasks

localden added 2 commits October 21, 2025 20:53

Script changes

d6136cb

Create create-release-packages.ps1

f7fe48b

Copilot AI review requested due to automatic review settings October 22, 2025 20:17

Copilot AI reviewed Oct 22, 2025

View reviewed changes

anchildress1 reviewed Oct 31, 2025

View reviewed changes

	info_table.add_row("Python", f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}")
	info_table.add_row("Python", platform.python_version())

-            # Clean branch name: remove leading markers and remote prefixes
+            # Clean branch name: remove leading markers and remote prefixes
+            # The following regex removes:
+            #   - Git's current branch marker ('*') and leading whitespace (e.g., '* main')
+            #   - Remote prefixes (e.g., 'remotes/origin/')


		1. For each task in the list, use the GitHub MCP server to create a new issue in the repository that is representative of the Git remote.

		UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL

(feat): Enhancements to Spec Kit #986

Are you sure you want to change the base?

(feat): Enhancements to Spec Kit #986

Conversation

localden commented Oct 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Screenshots

Hand-offs

Version

References

Behavior notes

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

crisweber2600 left a comment

Choose a reason for hiding this comment

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Oct 22, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Copilot AI Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 22, 2025

Choose a reason for hiding this comment

Uh oh!

N0SAFE commented Oct 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mfsbo commented Oct 26, 2025

Uh oh!

artk42 commented Oct 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

anchildress1 commented Oct 31, 2025

Uh oh!

anchildress1 Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

anchildress1 Oct 31, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

localden commented Oct 21, 2025 •

edited

Loading

N0SAFE commented Oct 23, 2025 •

edited

Loading

artk42 commented Oct 29, 2025 •

edited

Loading