💫 Toolkit to help you get started with SDD or any other process!
Create create-release-packages.ps1
den (work)f7fe48bd6af3
diff --git a/.github/workflows/scripts/create-release-packages.ps1 b/.github/workflows/scripts/create-release-packages.ps1new file mode 100644index 000000000..3bf74c92d--- /dev/null+++ b/.github/workflows/scripts/create-release-packages.ps1@@ -0,0 +1,416 @@+#!/usr/bin/env pwsh+#requires -Version 7.0++<#+.SYNOPSIS+ Build Spec Kit template release archives for each supported AI assistant and script type.++.DESCRIPTION+ create-release-packages.ps1 (workflow-local)+ Build Spec Kit template release archives for each supported AI assistant and script type.++.PARAMETER Version+ Version string with leading 'v' (e.g., v0.2.0)++.PARAMETER Agents+ Comma or space separated subset of agents to build (default: all)+ Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, q++.PARAMETER Scripts+ Comma or space separated subset of script types to build (default: both)+ Valid scripts: sh, ps++.EXAMPLE+ .\create-release-packages.ps1 -Version v0.2.0++.EXAMPLE+ .\create-release-packages.ps1 -Version v0.2.0 -Agents claude,copilot -Scripts sh++.EXAMPLE+ .\create-release-packages.ps1 -Version v0.2.0 -Agents claude -Scripts ps+#>++param(+ [Parameter(Mandatory=$true, Position=0)]+ [string]$Version,++ [Parameter(Mandatory=$false)]+ [string]$Agents = "",++ [Parameter(Mandatory=$false)]+ [string]$Scripts = ""+)++$ErrorActionPreference = "Stop"++# Validate version format+if ($Version -notmatch '^v\d+\.\d+\.\d+$') {+ Write-Error "Version must look like v0.0.0"+ exit 1+}++Write-Host "Building release packages for $Version"++# Create and use .genreleases directory for all build artifacts+$GenReleasesDir = ".genreleases"+if (Test-Path $GenReleasesDir) {+ Remove-Item -Path $GenReleasesDir -Recurse -Force -ErrorAction SilentlyContinue+}+New-Item -ItemType Directory -Path $GenReleasesDir -Force | Out-Null++function Rewrite-Paths {+ param([string]$Content)++ $Content = $Content -replace '(/?)\bmemory/', '.specify/memory/'+ $Content = $Content -replace '(/?)\bscripts/', '.specify/scripts/'+ $Content = $Content -replace '(/?)\btemplates/', '.specify/templates/'+ return $Content+}++function Generate-Commands {+ param(+ [string]$Agent,+ [string]$Extension,+ [string]$ArgFormat,+ [string]$OutputDir,+ [string]$ScriptVariant+ )++ New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null++ $templates = Get-ChildItem -Path "templates/commands/*.md" -File -ErrorAction SilentlyContinue++ foreach ($template in $templates) {+ $name = [System.IO.Path]::GetFileNameWithoutExtension($template.Name)++ # Read file content and normalize line endings+ $fileContent = (Get-Content -Path $template.FullName -Raw) -replace "`r`n", "`n"++ # Extract description from YAML frontmatter+ $description = ""+ if ($fileContent -match '(?m)^description:\s*(.+)$') {+ $description = $matches[1]+ }++ # Extract script command from YAML frontmatter+ $scriptCommand = ""+ if ($fileContent -match "(?m)^\s*${ScriptVariant}:\s*(.+)$") {+ $scriptCommand = $matches[1]+ }++ if ([string]::IsNullOrEmpty($scriptCommand)) {+ Write-Warning "No script command found for $ScriptVariant in $($template.Name)"+ $scriptCommand = "(Missing script command for $ScriptVariant)"+ }++ # Extract agent_script command from YAML frontmatter if present+ $agentScriptCommand = ""+ if ($fileContent -match "(?ms)agent_scripts:.*?^\s*${ScriptVariant}:\s*(.+?)$") {+ $agentScriptCommand = $matches[1].Trim()+ }++ # Replace {SCRIPT} placeholder with the script command+ $body = $fileContent -replace '\{SCRIPT\}', $scriptCommand++ # Replace {AGENT_SCRIPT} placeholder with the agent script command if found+ if (-not [string]::IsNullOrEmpty($agentScriptCommand)) {+ $body = $body -replace '\{AGENT_SCRIPT\}', $agentScriptCommand+ }++ # Remove the scripts: and agent_scripts: sections from frontmatter+ $lines = $body -split "`n"+ $outputLines = @()+ $inFrontmatter = $false+ $skipScripts = $false+ $dashCount = 0++ foreach ($line in $lines) {+ if ($line -match '^---$') {+ $outputLines += $line+ $dashCount+++ if ($dashCount -eq 1) {+ $inFrontmatter = $true+ } else {+ $inFrontmatter = $false+ }+ continue+ }++ if ($inFrontmatter) {+ if ($line -match '^(scripts|agent_scripts):$') {+ $skipScripts = $true+ continue+ }+ if ($line -match '^[a-zA-Z].*:' -and $skipScripts) {+ $skipScripts = $false+ }+ if ($skipScripts -and $line -match '^\s+') {+ continue+ }+ }++ $outputLines += $line+ }++ $body = $outputLines -join "`n"++ # Apply other substitutions+ $body = $body -replace '\{ARGS\}', $ArgFormat+ $body = $body -replace '__AGENT__', $Agent+ $body = Rewrite-Paths -Content $body++ # Generate output file based on extension+ $outputFile = Join-Path $OutputDir "speckit.$name.$Extension"++ switch ($Extension) {+ 'toml' {+ $body = $body -replace '\\', '\\'+ $output = "description = `"$description`"`n`nprompt = `"`"`"`n$body`n`"`"`""+ Set-Content -Path $outputFile -Value $output -NoNewline+ }+ 'md' {+ Set-Content -Path $outputFile -Value $body -NoNewline+ }+ 'chatmode.md' {+ Set-Content -Path $outputFile -Value $body -NoNewline+ }+ }+ }+}++function Generate-CopilotPrompts {+ param(+ [string]$ChatmodesDir,+ [string]$PromptsDir+ )++ New-Item -ItemType Directory -Path $PromptsDir -Force | Out-Null++ $chatmodeFiles = Get-ChildItem -Path "$ChatmodesDir/speckit.*.chatmode.md" -File -ErrorAction SilentlyContinue++ foreach ($chatmodeFile in $chatmodeFiles) {+ $basename = $chatmodeFile.Name -replace '\.chatmode\.md$', ''+ $promptFile = Join-Path $PromptsDir "$basename.prompt.md"++ $content = @"+---+agent: $basename+---+"@+ Set-Content -Path $promptFile -Value $content+ }+}++function Build-Variant {+ param(+ [string]$Agent,+ [string]$Script+ )++ $baseDir = Join-Path $GenReleasesDir "sdd-${Agent}-package-${Script}"+ Write-Host "Building $Agent ($Script) package..."+ New-Item -ItemType Directory -Path $baseDir -Force | Out-Null++ # Copy base structure but filter scripts by variant+ $specDir = Join-Path $baseDir ".specify"+ New-Item -ItemType Directory -Path $specDir -Force | Out-Null++ # Copy memory directory+ if (Test-Path "memory") {+ Copy-Item -Path "memory" -Destination $specDir -Recurse -Force+ Write-Host "Copied memory -> .specify"+ }++ # Only copy the relevant script variant directory+ if (Test-Path "scripts") {+ $scriptsDestDir = Join-Path $specDir "scripts"+ New-Item -ItemType Directory -Path $scriptsDestDir -Force | Out-Null++ switch ($Script) {+ 'sh' {+ if (Test-Path "scripts/bash") {+ Copy-Item -Path "scripts/bash" -Destination $scriptsDestDir -Recurse -Force+ Write-Host "Copied scripts/bash -> .specify/scripts"+ }+ }+ 'ps' {+ if (Test-Path "scripts/powershell") {+ Copy-Item -Path "scripts/powershell" -Destination $scriptsDestDir -Recurse -Force+ Write-Host "Copied scripts/powershell -> .specify/scripts"+ }+ }+ }++ # Copy any script files that aren't in variant-specific directories+ Get-ChildItem -Path "scripts" -File -ErrorAction SilentlyContinue | ForEach-Object {+ Copy-Item -Path $_.FullName -Destination $scriptsDestDir -Force+ }+ }++ # Copy templates (excluding commands directory and vscode-settings.json)+ if (Test-Path "templates") {+ $templatesDestDir = Join-Path $specDir "templates"+ New-Item -ItemType Directory -Path $templatesDestDir -Force | Out-Null++ Get-ChildItem -Path "templates" -Recurse -File | Where-Object {+ $_.FullName -notmatch 'templates[/\\]commands[/\\]' -and $_.Name -ne 'vscode-settings.json'+ } | ForEach-Object {+ $relativePath = $_.FullName.Substring((Resolve-Path "templates").Path.Length + 1)+ $destFile = Join-Path $templatesDestDir $relativePath+ $destFileDir = Split-Path $destFile -Parent+ New-Item -ItemType Directory -Path $destFileDir -Force | Out-Null+ Copy-Item -Path $_.FullName -Destination $destFile -Force+ }+ Write-Host "Copied templates -> .specify/templates"+ }++ # Generate agent-specific command files+ switch ($Agent) {+ 'claude' {+ $cmdDir = Join-Path $baseDir ".claude/commands"+ Generate-Commands -Agent 'claude' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'gemini' {+ $cmdDir = Join-Path $baseDir ".gemini/commands"+ Generate-Commands -Agent 'gemini' -Extension 'toml' -ArgFormat '{{args}}' -OutputDir $cmdDir -ScriptVariant $Script+ if (Test-Path "agent_templates/gemini/GEMINI.md") {+ Copy-Item -Path "agent_templates/gemini/GEMINI.md" -Destination (Join-Path $baseDir "GEMINI.md")+ }+ }+ 'copilot' {+ $chatmodesDir = Join-Path $baseDir ".github/chatmodes"+ Generate-Commands -Agent 'copilot' -Extension 'chatmode.md' -ArgFormat '$ARGUMENTS' -OutputDir $chatmodesDir -ScriptVariant $Script++ # Generate companion prompt files+ $promptsDir = Join-Path $baseDir ".github/prompts"+ Generate-CopilotPrompts -ChatmodesDir $chatmodesDir -PromptsDir $promptsDir++ # Create VS Code workspace settings+ $vscodeDir = Join-Path $baseDir ".vscode"+ New-Item -ItemType Directory -Path $vscodeDir -Force | Out-Null+ if (Test-Path "templates/vscode-settings.json") {+ Copy-Item -Path "templates/vscode-settings.json" -Destination (Join-Path $vscodeDir "settings.json")+ }+ }+ 'cursor-agent' {+ $cmdDir = Join-Path $baseDir ".cursor/commands"+ Generate-Commands -Agent 'cursor-agent' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'qwen' {+ $cmdDir = Join-Path $baseDir ".qwen/commands"+ Generate-Commands -Agent 'qwen' -Extension 'toml' -ArgFormat '{{args}}' -OutputDir $cmdDir -ScriptVariant $Script+ if (Test-Path "agent_templates/qwen/QWEN.md") {+ Copy-Item -Path "agent_templates/qwen/QWEN.md" -Destination (Join-Path $baseDir "QWEN.md")+ }+ }+ 'opencode' {+ $cmdDir = Join-Path $baseDir ".opencode/command"+ Generate-Commands -Agent 'opencode' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'windsurf' {+ $cmdDir = Join-Path $baseDir ".windsurf/workflows"+ Generate-Commands -Agent 'windsurf' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'codex' {+ $cmdDir = Join-Path $baseDir ".codex/prompts"+ Generate-Commands -Agent 'codex' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'kilocode' {+ $cmdDir = Join-Path $baseDir ".kilocode/workflows"+ Generate-Commands -Agent 'kilocode' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'auggie' {+ $cmdDir = Join-Path $baseDir ".augment/commands"+ Generate-Commands -Agent 'auggie' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'roo' {+ $cmdDir = Join-Path $baseDir ".roo/commands"+ Generate-Commands -Agent 'roo' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'codebuddy' {+ $cmdDir = Join-Path $baseDir ".codebuddy/commands"+ Generate-Commands -Agent 'codebuddy' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'amp' {+ $cmdDir = Join-Path $baseDir ".agents/commands"+ Generate-Commands -Agent 'amp' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ 'q' {+ $cmdDir = Join-Path $baseDir ".amazonq/prompts"+ Generate-Commands -Agent 'q' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }+ }++ # Create zip archive+ $zipFile = Join-Path $GenReleasesDir "spec-kit-template-${Agent}-${Script}-${Version}.zip"+ Compress-Archive -Path "$baseDir/*" -DestinationPath $zipFile -Force+ Write-Host "Created $zipFile"+}++# Define all agents and scripts+$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'q')+$AllScripts = @('sh', 'ps')++function Normalize-List {+ param([string]$Input)++ if ([string]::IsNullOrEmpty($Input)) {+ return @()+ }++ # Split by comma or space and remove duplicates while preserving order+ $items = $Input -split '[,\s]+' | Where-Object { $_ } | Select-Object -Unique+ return $items+}++function Validate-Subset {+ param(+ [string]$Type,+ [string[]]$Allowed,+ [string[]]$Items+ )++ $ok = $true+ foreach ($item in $Items) {+ if ($item -notin $Allowed) {+ Write-Error "Unknown $Type '$item' (allowed: $($Allowed -join ', '))"+ $ok = $false+ }+ }+ return $ok+}++# Determine agent list+if (-not [string]::IsNullOrEmpty($Agents)) {+ $AgentList = Normalize-List -Input $Agents+ if (-not (Validate-Subset -Type 'agent' -Allowed $AllAgents -Items $AgentList)) {+ exit 1+ }+} else {+ $AgentList = $AllAgents+}++# Determine script list+if (-not [string]::IsNullOrEmpty($Scripts)) {+ $ScriptList = Normalize-List -Input $Scripts+ if (-not (Validate-Subset -Type 'script' -Allowed $AllScripts -Items $ScriptList)) {+ exit 1+ }+} else {+ $ScriptList = $AllScripts+}++Write-Host "Agents: $($AgentList -join ', ')"+Write-Host "Scripts: $($ScriptList -join ', ')"++# Build all variants+foreach ($agent in $AgentList) {+ foreach ($script in $ScriptList) {+ Build-Variant -Agent $agent -Script $script+ }+}++Write-Host "`nArchives in ${GenReleasesDir}:"+Get-ChildItem -Path $GenReleasesDir -Filter "spec-kit-template-*-${Version}.zip" | ForEach-Object {+ Write-Host " $($_.Name)"+}