π« Toolkit to help you get started with SDD or any other process!
feat: add Kimi Code CLI agent support (#1790)
Fanch Daniele56d37db8ccf
diff --git a/.devcontainer/post-create.sh b/.devcontainer/post-create.shindex 024ff0db4..d7d3da588 100755--- a/.devcontainer/post-create.sh+++ b/.devcontainer/post-create.sh@@ -8,15 +8,15 @@ run_command() {local command_to_run="$*"local outputlocal exit_code-+# Capture all output (stdout and stderr)output=$(eval "$command_to_run" 2>&1) || exit_code=$?exit_code=${exit_code:-0}-+if [ $exit_code -ne 0 ]; thenecho -e "\033[0;31m[ERROR] Command failed (Exit Code $exit_code): $command_to_run\033[0m" >&2echo -e "\033[0;31m$output\033[0m" >&2-+exit $exit_codefi}@@ -53,7 +53,7 @@ echo "β Done"echo -e "\nπ€ Installing Kiro CLI..."# https://kiro.dev/docs/cli/-KIRO_INSTALLER_URL="https://cli.kiro.dev/install"+KIRO_INSTALLER_URL="https://kiro.dev/install.sh"KIRO_INSTALLER_SHA256="7487a65cf310b7fb59b357c4b5e6e3f3259d383f4394ecedb39acf70f307cffb"KIRO_INSTALLER_PATH="$(mktemp)"@@ -80,6 +80,11 @@ firun_command "$kiro_binary --help > /dev/null"echo "β Done"+echo -e "\nπ€ Installing Kimi CLI..."+# https://code.kimi.com+run_command "pipx install kimi-cli"+echo "β Done"+echo -e "\nπ€ Installing CodeBuddy CLI..."run_command "npm install -g @tencent-ai/codebuddy-code@latest"echo "β Done"diff --git a/.github/workflows/scripts/create-github-release.sh b/.github/workflows/scripts/create-github-release.shold mode 100644new mode 100755index 29851a140..864e0011b--- a/.github/workflows/scripts/create-github-release.sh+++ b/.github/workflows/scripts/create-github-release.sh@@ -56,6 +56,8 @@ gh release create "$VERSION" \.genreleases/spec-kit-template-bob-ps-"$VERSION".zip \.genreleases/spec-kit-template-vibe-sh-"$VERSION".zip \.genreleases/spec-kit-template-vibe-ps-"$VERSION".zip \+ .genreleases/spec-kit-template-kimi-sh-"$VERSION".zip \+ .genreleases/spec-kit-template-kimi-ps-"$VERSION".zip \.genreleases/spec-kit-template-generic-sh-"$VERSION".zip \.genreleases/spec-kit-template-generic-ps-"$VERSION".zip \--title "Spec Kit Templates - $VERSION_NO_V" \diff --git a/.github/workflows/scripts/create-release-packages.ps1 b/.github/workflows/scripts/create-release-packages.ps1index 894ab38e7..8c7d4078f 100644--- a/.github/workflows/scripts/create-release-packages.ps1+++ b/.github/workflows/scripts/create-release-packages.ps1@@ -8,13 +8,13 @@.DESCRIPTIONcreate-release-packages.ps1 (workflow-local)Build Spec Kit template release archives for each supported AI assistant and script type.-+.PARAMETER VersionVersion string with leading 'v' (e.g., v0.2.0).PARAMETER AgentsComma 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, kiro-cli, bob, qodercli, shai, tabnine, agy, vibe, generic+ Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, kiro-cli, bob, qodercli, shai, tabnine, agy, vibe, kimi, generic.PARAMETER ScriptsComma or space separated subset of script types to build (default: both)@@ -33,10 +33,10 @@param([Parameter(Mandatory=$true, Position=0)][string]$Version,-+[Parameter(Mandatory=$false)][string]$Agents = "",-+[Parameter(Mandatory=$false)][string]$Scripts = "")@@ -60,7 +60,7 @@ New-Item -ItemType Directory -Path $GenReleasesDir -Force | Out-Nullfunction Rewrite-Paths {param([string]$Content)-+$Content = $Content -replace '(/?)\bmemory/', '.specify/memory/'$Content = $Content -replace '(/?)\bscripts/', '.specify/scripts/'$Content = $Content -replace '(/?)\btemplates/', '.specify/templates/'@@ -75,55 +75,55 @@ function Generate-Commands {[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 foundif (-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@@ -135,7 +135,7 @@ function Generate-Commands {}continue}-+if ($inFrontmatter) {if ($line -match '^(scripts|agent_scripts):$') {$skipScripts = $true@@ -148,20 +148,20 @@ function Generate-Commands {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 '\\', '\\'@@ -183,15 +183,15 @@ function Generate-CopilotPrompts {[string]$AgentsDir,[string]$PromptsDir)-+New-Item -ItemType Directory -Path $PromptsDir -Force | Out-Null-+$agentFiles = Get-ChildItem -Path "$AgentsDir/speckit.*.agent.md" -File -ErrorAction SilentlyContinue-+foreach ($agentFile in $agentFiles) {$basename = $agentFile.Name -replace '\.agent\.md$', ''$promptFile = Join-Path $PromptsDir "$basename.prompt.md"-+$content = @"---agent: $basename@@ -201,31 +201,118 @@ agent: $basename}}+# Create Kimi Code skills in .kimi/skills/<name>/SKILL.md format.+# Kimi CLI discovers skills as directories containing a SKILL.md file,+# invoked with /skill:<name> (e.g. /skill:speckit.specify).+function New-KimiSkills {+ param(+ [string]$SkillsDir,+ [string]$ScriptVariant+ )++ $templates = Get-ChildItem -Path "templates/commands/*.md" -File -ErrorAction SilentlyContinue++ foreach ($template in $templates) {+ $name = [System.IO.Path]::GetFileNameWithoutExtension($template.Name)+ $skillName = "speckit.$name"+ $skillDir = Join-Path $SkillsDir $skillName+ New-Item -ItemType Directory -Force -Path $skillDir | Out-Null++ $fileContent = (Get-Content -Path $template.FullName -Raw) -replace "`r`n", "`n"++ # Extract description+ $description = "Spec Kit: $name workflow"+ if ($fileContent -match '(?m)^description:\s*(.+)$') {+ $description = $matches[1]+ }++ # Extract script command+ $scriptCommand = "(Missing script command for $ScriptVariant)"+ if ($fileContent -match "(?m)^\s*${ScriptVariant}:\s*(.+)$") {+ $scriptCommand = $matches[1]+ }++ # Extract agent_script command from frontmatter if present+ $agentScriptCommand = ""+ if ($fileContent -match "(?ms)agent_scripts:.*?^\s*${ScriptVariant}:\s*(.+?)$") {+ $agentScriptCommand = $matches[1].Trim()+ }++ # Replace {SCRIPT}, strip scripts sections, rewrite paths+ $body = $fileContent -replace '\{SCRIPT\}', $scriptCommand+ if (-not [string]::IsNullOrEmpty($agentScriptCommand)) {+ $body = $body -replace '\{AGENT_SCRIPT\}', $agentScriptCommand+ }++ $lines = $body -split "`n"+ $outputLines = @()+ $inFrontmatter = $false+ $skipScripts = $false+ $dashCount = 0++ foreach ($line in $lines) {+ if ($line -match '^---$') {+ $outputLines += $line+ $dashCount+++ $inFrontmatter = ($dashCount -eq 1)+ 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"+ $body = $body -replace '\{ARGS\}', '$ARGUMENTS'+ $body = $body -replace '__AGENT__', 'kimi'+ $body = Rewrite-Paths -Content $body++ # Strip existing frontmatter, keep only body+ $templateBody = ""+ $fmCount = 0+ $inBody = $false+ foreach ($line in ($body -split "`n")) {+ if ($line -match '^---$') {+ $fmCount+++ if ($fmCount -eq 2) { $inBody = $true }+ continue+ }+ if ($inBody) { $templateBody += "$line`n" }+ }++ $skillContent = "---`nname: `"$skillName`"`ndescription: `"$description`"`n---`n`n$templateBody"+ Set-Content -Path (Join-Path $skillDir "SKILL.md") -Value $skillContent -NoNewline+ }+}+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 directoryif (Test-Path "memory") {Copy-Item -Path "memory" -Destination $specDir -Recurse -ForceWrite-Host "Copied memory -> .specify"}-+# Only copy the relevant script variant directoryif (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") {@@ -240,18 +327,17 @@ function Build-Variant {}}}-- # 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 {@@ -263,7 +349,7 @@ function Build-Variant {}Write-Host "Copied templates -> .specify/templates"}-+# Generate agent-specific command filesswitch ($Agent) {'claude' {@@ -280,12 +366,10 @@ function Build-Variant {'copilot' {$agentsDir = Join-Path $baseDir ".github/agents"Generate-Commands -Agent 'copilot' -Extension 'agent.md' -ArgFormat '$ARGUMENTS' -OutputDir $agentsDir -ScriptVariant $Script-- # Generate companion prompt files+$promptsDir = Join-Path $baseDir ".github/prompts"Generate-CopilotPrompts -AgentsDir $agentsDir -PromptsDir $promptsDir-- # Create VS Code workspace settings+$vscodeDir = Join-Path $baseDir ".vscode"New-Item -ItemType Directory -Path $vscodeDir -Force | Out-Nullif (Test-Path "templates/vscode-settings.json") {@@ -361,19 +445,24 @@ function Build-Variant {$cmdDir = Join-Path $baseDir ".agent/workflows"Generate-Commands -Agent 'agy' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script}- 'generic' {- $cmdDir = Join-Path $baseDir ".speckit/commands"- Generate-Commands -Agent 'generic' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script- }'vibe' {$cmdDir = Join-Path $baseDir ".vibe/prompts"Generate-Commands -Agent 'vibe' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script}+ 'kimi' {+ $skillsDir = Join-Path $baseDir ".kimi/skills"+ New-Item -ItemType Directory -Force -Path $skillsDir | Out-Null+ New-KimiSkills -SkillsDir $skillsDir -ScriptVariant $Script+ }+ 'generic' {+ $cmdDir = Join-Path $baseDir ".speckit/commands"+ Generate-Commands -Agent 'generic' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script+ }default {throw "Unsupported agent '$Agent'."}}-+# Create zip archive$zipFile = Join-Path $GenReleasesDir "spec-kit-template-${Agent}-${Script}-${Version}.zip"Compress-Archive -Path "$baseDir/*" -DestinationPath $zipFile -Force@@ -381,17 +470,16 @@ function Build-Variant {}# Define all agents and scripts-$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'kiro-cli', 'bob', 'qodercli', 'shai', 'tabnine', 'agy', 'vibe', 'generic')+$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'kiro-cli', 'bob', 'qodercli', 'shai', 'tabnine', 'agy', 'vibe', 'kimi', 'generic')$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 -Uniquereturn $items}@@ -402,7 +490,7 @@ function Validate-Subset {[string[]]$Allowed,[string[]]$Items)-+$ok = $trueforeach ($item in $Items) {if ($item -notin $Allowed) {diff --git a/.github/workflows/scripts/create-release-packages.sh b/.github/workflows/scripts/create-release-packages.shindex af9880b61..8be5a0549 100755--- a/.github/workflows/scripts/create-release-packages.sh+++ b/.github/workflows/scripts/create-release-packages.sh@@ -6,7 +6,7 @@ set -euo pipefail# Usage: .github/workflows/scripts/create-release-packages.sh <version># Version argument should include leading 'v'.# Optionally set AGENTS and/or SCRIPTS env vars to limit what gets built.-# AGENTS : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli generic (default: all)+# AGENTS : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi generic (default: all)# SCRIPTS : space or comma separated subset of: sh ps (default: both)# Examples:# AGENTS=claude SCRIPTS=sh $0 v0.2.0@@ -45,19 +45,19 @@ generate_commands() {[[ -f "$template" ]] || continuelocal name description script_command agent_script_command bodyname=$(basename "$template" .md)-+# Normalize line endingsfile_content=$(tr -d '\r' < "$template")-+# Extract description and script command from YAML frontmatterdescription=$(printf '%s\n' "$file_content" | awk '/^description:/ {sub(/^description:[[:space:]]*/, ""); print; exit}')script_command=$(printf '%s\n' "$file_content" | awk -v sv="$script_variant" '/^[[:space:]]*'"$script_variant"':[[:space:]]*/ {sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, ""); print; exit}')-+if [[ -z $script_command ]]; thenecho "Warning: no script command found for $script_variant in $template" >&2script_command="(Missing script command for $script_variant)"fi-+# Extract agent_script command from YAML frontmatter if presentagent_script_command=$(printf '%s\n' "$file_content" | awk '/^agent_scripts:$/ { in_agent_scripts=1; next }@@ -68,15 +68,15 @@ generate_commands() {}in_agent_scripts && /^[a-zA-Z]/ { in_agent_scripts=0 }')-+# Replace {SCRIPT} placeholder with the script commandbody=$(printf '%s\n' "$file_content" | sed "s|{SCRIPT}|${script_command}|g")-+# Replace {AGENT_SCRIPT} placeholder with the agent script command if foundif [[ -n $agent_script_command ]]; thenbody=$(printf '%s\n' "$body" | sed "s|{AGENT_SCRIPT}|${agent_script_command}|g")fi-+# Remove the scripts: and agent_scripts: sections from frontmatter while preserving YAML structurebody=$(printf '%s\n' "$body" | awk '/^---$/ { print; if (++dash_count == 1) in_frontmatter=1; else in_frontmatter=0; next }@@ -86,10 +86,10 @@ generate_commands() {in_frontmatter && skip_scripts && /^[[:space:]]/ { next }{ print }')-+# Apply other substitutionsbody=$(printf '%s\n' "$body" | sed "s/{ARGS}/$arg_format/g" | sed "s/__AGENT__/$agent/g" | rewrite_paths)-+case $ext intoml)body=$(printf '%s\n' "$body" | sed 's/\\/\\\\/g')@@ -105,15 +105,14 @@ generate_commands() {generate_copilot_prompts() {local agents_dir=$1 prompts_dir=$2mkdir -p "$prompts_dir"-+# Generate a .prompt.md file for each .agent.md filefor agent_file in "$agents_dir"/speckit.*.agent.md; do[[ -f "$agent_file" ]] || continue-+local basename=$(basename "$agent_file" .agent.md)local prompt_file="$prompts_dir/${basename}.prompt.md"-- # Create prompt file with agent frontmatter+cat > "$prompt_file" <<EOF---agent: ${basename}@@ -122,41 +121,104 @@ EOFdone}+# Create Kimi Code skills in .kimi/skills/<name>/SKILL.md format.+# Kimi CLI discovers skills as directories containing a SKILL.md file,+# invoked with /skill:<name> (e.g. /skill:speckit.specify).+create_kimi_skills() {+ local skills_dir="$1"+ local script_variant="$2"++ for template in templates/commands/*.md; do+ [[ -f "$template" ]] || continue+ local name+ name=$(basename "$template" .md)+ local skill_name="speckit.${name}"+ local skill_dir="${skills_dir}/${skill_name}"+ mkdir -p "$skill_dir"++ local file_content+ file_content=$(tr -d '\r' < "$template")++ # Extract description from frontmatter+ local description+ description=$(printf '%s\n' "$file_content" | awk '/^description:/ {sub(/^description:[[:space:]]*/, ""); print; exit}')+ [[ -z "$description" ]] && description="Spec Kit: ${name} workflow"++ # Extract script command+ local script_command+ script_command=$(printf '%s\n' "$file_content" | awk -v sv="$script_variant" '/^[[:space:]]*'"$script_variant"':[[:space:]]*/ {sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, ""); print; exit}')+ [[ -z "$script_command" ]] && script_command="(Missing script command for $script_variant)"++ # Extract agent_script command from frontmatter if present+ local agent_script_command+ agent_script_command=$(printf '%s\n' "$file_content" | awk '+ /^agent_scripts:$/ { in_agent_scripts=1; next }+ in_agent_scripts && /^[[:space:]]*'"$script_variant"':[[:space:]]*/ {+ sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, "")+ exit+ }+ in_agent_scripts && /^[a-zA-Z]/ { in_agent_scripts=0 }+ ')++ # Build body: replace placeholders, strip scripts sections, rewrite paths+ local body+ body=$(printf '%s\n' "$file_content" | sed "s|{SCRIPT}|${script_command}|g")+ if [[ -n $agent_script_command ]]; then+ body=$(printf '%s\n' "$body" | sed "s|{AGENT_SCRIPT}|${agent_script_command}|g")+ fi+ body=$(printf '%s\n' "$body" | awk '+ /^---$/ { print; if (++dash_count == 1) in_frontmatter=1; else in_frontmatter=0; next }+ in_frontmatter && /^scripts:$/ { skip_scripts=1; next }+ in_frontmatter && /^agent_scripts:$/ { skip_scripts=1; next }+ in_frontmatter && /^[a-zA-Z].*:/ && skip_scripts { skip_scripts=0 }+ in_frontmatter && skip_scripts && /^[[:space:]]/ { next }+ { print }+ ')+ body=$(printf '%s\n' "$body" | sed 's/{ARGS}/\$ARGUMENTS/g' | sed 's/__AGENT__/kimi/g' | rewrite_paths)++ # Strip existing frontmatter and prepend Kimi frontmatter+ local template_body+ template_body=$(printf '%s\n' "$body" | awk '/^---/{p++; if(p==2){found=1; next}} found')++ {+ printf -- '---\n'+ printf 'name: "%s"\n' "$skill_name"+ printf 'description: "%s"\n' "$description"+ printf -- '---\n\n'+ printf '%s\n' "$template_body"+ } > "$skill_dir/SKILL.md"+ done+}+build_variant() {local agent=$1 script=$2local base_dir="$GENRELEASES_DIR/sdd-${agent}-package-${script}"echo "Building $agent ($script) package..."mkdir -p "$base_dir"-+# Copy base structure but filter scripts by variantSPEC_DIR="$base_dir/.specify"mkdir -p "$SPEC_DIR"-+[[ -d memory ]] && { cp -r memory "$SPEC_DIR/"; echo "Copied memory -> .specify"; }-+# Only copy the relevant script variant directoryif [[ -d scripts ]]; thenmkdir -p "$SPEC_DIR/scripts"case $script insh)[[ -d scripts/bash ]] && { cp -r scripts/bash "$SPEC_DIR/scripts/"; echo "Copied scripts/bash -> .specify/scripts"; }- # Copy any script files that aren't in variant-specific directoriesfind scripts -maxdepth 1 -type f -exec cp {} "$SPEC_DIR/scripts/" \; 2>/dev/null || true;;ps)[[ -d scripts/powershell ]] && { cp -r scripts/powershell "$SPEC_DIR/scripts/"; echo "Copied scripts/powershell -> .specify/scripts"; }- # Copy any script files that aren't in variant-specific directoriesfind scripts -maxdepth 1 -type f -exec cp {} "$SPEC_DIR/scripts/" \; 2>/dev/null || true;;esacfi-+[[ -d templates ]] && { mkdir -p "$SPEC_DIR/templates"; find templates -type f -not -path "templates/commands/*" -not -name "vscode-settings.json" -exec cp --parents {} "$SPEC_DIR"/ \; ; echo "Copied templates -> .specify/templates"; }-- # NOTE: We substitute {ARGS} internally. Outward tokens differ intentionally:- # * Markdown/prompt (claude, copilot, cursor-agent, opencode): $ARGUMENTS- # * TOML (gemini, qwen, tabnine): {{args}}- # This keeps formats readable without extra abstraction.case $agent inclaude)@@ -169,9 +231,7 @@ build_variant() {copilot)mkdir -p "$base_dir/.github/agents"generate_commands copilot agent.md "\$ARGUMENTS" "$base_dir/.github/agents" "$script"- # Generate companion prompt filesgenerate_copilot_prompts "$base_dir/.github/agents" "$base_dir/.github/prompts"- # Create VS Code workspace settingsmkdir -p "$base_dir/.vscode"[[ -f templates/vscode-settings.json ]] && cp templates/vscode-settings.json "$base_dir/.vscode/settings.json";;@@ -228,6 +288,9 @@ build_variant() {vibe)mkdir -p "$base_dir/.vibe/prompts"generate_commands vibe md "\$ARGUMENTS" "$base_dir/.vibe/prompts" "$script" ;;+ kimi)+ mkdir -p "$base_dir/.kimi/skills"+ create_kimi_skills "$base_dir/.kimi/skills" "$script" ;;generic)mkdir -p "$base_dir/.speckit/commands"generate_commands generic md "\$ARGUMENTS" "$base_dir/.speckit/commands" "$script" ;;@@ -237,11 +300,10 @@ build_variant() {}# Determine agent list-ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli generic)+ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi generic)ALL_SCRIPTS=(sh ps)norm_list() {- # convert comma+space separated -> line separated unique while preserving order of first occurrencetr ',\n' ' ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?"\n":"") $i);out=1}}}END{printf("\n")}'}diff --git a/AGENTS.md b/AGENTS.mdindex 8e7631b1d..aa3730222 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -48,6 +48,7 @@ Specify supports multiple AI agents by generating agent-specific command files a| **Amp** | `.agents/commands/` | Markdown | `amp` | Amp CLI || **SHAI** | `.shai/commands/` | Markdown | `shai` | SHAI CLI || **Tabnine CLI** | `.tabnine/agent/commands/` | TOML | `tabnine` | Tabnine CLI |+| **Kimi Code** | `.kimi/skills/` | Markdown | `kimi` | Kimi Code CLI (Moonshot AI) || **IBM Bob** | `.bob/commands/` | Markdown | N/A (IDE-based) | IBM Bob IDE || **Generic** | User-specified via `--ai-commands-dir` | Markdown | N/A | Bring your own agent |@@ -324,6 +325,7 @@ Require a command-line tool to be installed:- **Amp**: `amp` CLI- **SHAI**: `shai` CLI- **Tabnine CLI**: `tabnine` CLI+- **Kimi Code**: `kimi` CLI### IDE-Based Agents@@ -337,7 +339,7 @@ Work within integrated development environments:### Markdown Format-Used by: Claude, Cursor, opencode, Windsurf, Kiro CLI, Amp, SHAI, IBM Bob+Used by: Claude, Cursor, opencode, Windsurf, Kiro CLI, Amp, SHAI, IBM Bob, Kimi Code**Standard format:**diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 45b662160..ac96960d7 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -17,6 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0### Changed+- feat: add Kimi Code CLI agent support- fix: sync agent list comments with actual supported agents (#1785)- feat(extensions): support multiple active catalogs simultaneously (#1720)- Pavel/add tabnine cli support (#1503)diff --git a/README.md b/README.mdindex c3afd1846..5aca4901c 100644--- a/README.md+++ b/README.md@@ -179,6 +179,7 @@ See Spec-Driven Development in action across different scenarios with these comm| [SHAI (OVHcloud)](https://github.com/ovh/shai) | β | || [Tabnine CLI](https://docs.tabnine.com/main/getting-started/tabnine-cli) | β | || [Mistral Vibe](https://github.com/mistralai/mistral-vibe) | β | |+| [Kimi Code](https://code.kimi.com/) | β | || [Windsurf](https://windsurf.com/) | β | || [Antigravity (agy)](https://antigravity.google/) | β | || Generic | β | Bring your own agent β use `--ai generic --ai-commands-dir <path>` for unsupported agents |@@ -192,14 +193,14 @@ The `specify` command supports the following options:| Command | Description || ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- || `init` | Initialize a new Specify project from the latest template |-| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`) |+| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`, `kimi`) |### `specify init` Arguments & Options| Argument/Option | Type | Description || ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- || `<project-name>` | Argument | Name for your new project directory (optional if using `--here`, or use `.` for current directory) |-| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, or `generic` (requires `--ai-commands-dir`) |+| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, `kimi`, or `generic` (requires `--ai-commands-dir`) || `--ai-commands-dir` | Option | Directory for agent command files (required with `--ai generic`, e.g. `.myagent/commands/`) || `--script` | Option | Script variant to use: `sh` (bash/zsh) or `ps` (PowerShell) || `--ignore-agent-tools` | Flag | Skip checks for AI agent tools like Claude Code |diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.shindex f67e2db99..b0022fd45 100644--- a/scripts/bash/update-agent-context.sh+++ b/scripts/bash/update-agent-context.sh@@ -30,12 +30,12 @@## 5. Multi-Agent Support# - Handles agent-specific file paths and naming conventions-# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Antigravity or Generic+# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Kimi Code, Antigravity or Generic# - Can update single agents or all existing agent files# - Creates default Claude file if no agent files exist## Usage: ./update-agent-context.sh [agent_type]-# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic+# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic# Leave empty to update all existing agent filesset -e@@ -78,6 +78,7 @@ KIRO_FILE="$REPO_ROOT/AGENTS.md"AGY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"BOB_FILE="$REPO_ROOT/AGENTS.md"VIBE_FILE="$REPO_ROOT/.vibe/agents/specify-agents.md"+KIMI_FILE="$REPO_ROOT/KIMI.md"# Template fileTEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md"@@ -665,12 +666,15 @@ update_specific_agent() {vibe)update_agent_file "$VIBE_FILE" "Mistral Vibe";;+ kimi)+ update_agent_file "$KIMI_FILE" "Kimi Code"+ ;;generic)log_info "Generic agent: no predefined context file. Use the agent-specific update script for your agent.";;*)log_error "Unknown agent type '$agent_type'"- log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic"+ log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic"exit 1;;esac@@ -769,6 +773,11 @@ update_all_existing_agents() {found_agent=truefi+ if [[ -f "$KIMI_FILE" ]]; then+ update_agent_file "$KIMI_FILE" "Kimi Code"+ found_agent=true+ fi+# If no agent files exist, create a default Claude fileif [[ "$found_agent" == false ]]; thenlog_info "No existing agent files found, creating default Claude file..."@@ -792,7 +801,7 @@ print_summary() {fiecho- log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic]"+ log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic]"}#==============================================================================diff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1index 816d4d586..95e636ba1 100644--- a/scripts/powershell/update-agent-context.ps1+++ b/scripts/powershell/update-agent-context.ps1@@ -9,7 +9,7 @@ Mirrors the behavior of scripts/bash/update-agent-context.sh:2. Plan Data Extraction3. Agent File Management (create from template or update existing)4. Content Generation (technology stack, recent changes, timestamp)- 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, generic)+ 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, kimi, generic).PARAMETER AgentTypeOptional agent key to update a single agent. If omitted, updates all existing agent files (creating a default Claude file if none exist).@@ -25,7 +25,7 @@ Relies on common helper functions in common.ps1#>param([Parameter(Position=0)]- [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','tabnine','kiro-cli','agy','bob','qodercli','vibe','generic')]+ [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','tabnine','kiro-cli','agy','bob','qodercli','vibe','kimi','generic')][string]$AgentType)@@ -63,6 +63,7 @@ $KIRO_FILE = Join-Path $REPO_ROOT 'AGENTS.md'$AGY_FILE = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'$BOB_FILE = Join-Path $REPO_ROOT 'AGENTS.md'$VIBE_FILE = Join-Path $REPO_ROOT '.vibe/agents/specify-agents.md'+$KIMI_FILE = Join-Path $REPO_ROOT 'KIMI.md'$TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md'@@ -406,8 +407,9 @@ function Update-SpecificAgent {'agy' { Update-AgentFile -TargetFile $AGY_FILE -AgentName 'Antigravity' }'bob' { Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob' }'vibe' { Update-AgentFile -TargetFile $VIBE_FILE -AgentName 'Mistral Vibe' }+ 'kimi' { Update-AgentFile -TargetFile $KIMI_FILE -AgentName 'Kimi Code' }'generic' { Write-Info 'Generic agent: no predefined context file. Use the agent-specific update script for your agent.' }- default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic'; return $false }+ default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|generic'; return $false }}}@@ -432,6 +434,7 @@ function Update-AllExistingAgents {if (Test-Path $AGY_FILE) { if (-not (Update-AgentFile -TargetFile $AGY_FILE -AgentName 'Antigravity')) { $ok = $false }; $found = $true }if (Test-Path $BOB_FILE) { if (-not (Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob')) { $ok = $false }; $found = $true }if (Test-Path $VIBE_FILE) { if (-not (Update-AgentFile -TargetFile $VIBE_FILE -AgentName 'Mistral Vibe')) { $ok = $false }; $found = $true }+ if (Test-Path $KIMI_FILE) { if (-not (Update-AgentFile -TargetFile $KIMI_FILE -AgentName 'Kimi Code')) { $ok = $false }; $found = $true }if (-not $found) {Write-Info 'No existing agent files found, creating default Claude file...'if (-not (Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }diff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.pyindex 209632a70..dac7eaa54 100644--- a/src/specify_cli/__init__.py+++ b/src/specify_cli/__init__.py@@ -265,6 +265,13 @@ AGENT_CONFIG = {"install_url": "https://github.com/mistralai/mistral-vibe","requires_cli": True,},+ "kimi": {+ "name": "Kimi Code",+ "folder": ".kimi/",+ "commands_subdir": "skills", # Kimi uses /skill:<name> with .kimi/skills/<name>/SKILL.md+ "install_url": "https://code.kimi.com/",+ "requires_cli": True,+ },"generic": {"name": "Generic (bring your own agent)","folder": None, # Set dynamically via --ai-commands-dir@@ -1188,7 +1195,12 @@ def install_ai_skills(project_path: Path, selected_ai: str, tracker: StepTracker# SKILL_DESCRIPTIONS lookups work.if command_name.startswith("speckit."):command_name = command_name[len("speckit."):]- skill_name = f"speckit-{command_name}"+ # Kimi CLI discovers skills by directory name and invokes them as+ # /skill:<name> β use dot separator to match packaging convention.+ if selected_ai == "kimi":+ skill_name = f"speckit.{command_name}"+ else:+ skill_name = f"speckit-{command_name}"# Create skill directory (additive β never removes existing content)skill_dir = skills_dir / skill_namediff --git a/src/specify_cli/extensions.py b/src/specify_cli/extensions.pyindex 53777bd6b..383ed2154 100644--- a/src/specify_cli/extensions.py+++ b/src/specify_cli/extensions.py@@ -727,7 +727,7 @@ class CommandRegistrar:"extension": ".md"},"roo": {- "dir": ".roo/rules",+ "dir": ".roo/commands","format": "markdown","args": "$ARGUMENTS","extension": ".md"@@ -773,6 +773,12 @@ class CommandRegistrar:"format": "markdown","args": "$ARGUMENTS","extension": ".md"+ },+ "kimi": {+ "dir": ".kimi/skills",+ "format": "markdown",+ "args": "$ARGUMENTS",+ "extension": "/SKILL.md"}}@@ -966,6 +972,7 @@ class CommandRegistrar:# Write command filedest_file = commands_dir / f"{cmd_name}{agent_config['extension']}"+ dest_file.parent.mkdir(parents=True, exist_ok=True)dest_file.write_text(output)# Generate companion .prompt.md for Copilot agents@@ -977,6 +984,7 @@ class CommandRegistrar:# Register aliasesfor alias in cmd_info.get("aliases", []):alias_file = commands_dir / f"{alias}{agent_config['extension']}"+ alias_file.parent.mkdir(parents=True, exist_ok=True)alias_file.write_text(output)# Generate companion .prompt.md for alias tooif agent_name == "copilot":diff --git a/tests/test_agent_config_consistency.py b/tests/test_agent_config_consistency.pyindex 3615dbc78..d77c6f10d 100644--- a/tests/test_agent_config_consistency.py+++ b/tests/test_agent_config_consistency.py@@ -171,3 +171,58 @@ class TestAgentConfigConsistency:def test_ai_help_includes_tabnine(self):"""CLI help text for --ai should include tabnine."""assert "tabnine" in AI_ASSISTANT_HELP++ # --- Kimi Code CLI consistency checks ---++ def test_kimi_in_agent_config(self):+ """AGENT_CONFIG should include kimi with correct folder and commands_subdir."""+ assert "kimi" in AGENT_CONFIG+ assert AGENT_CONFIG["kimi"]["folder"] == ".kimi/"+ assert AGENT_CONFIG["kimi"]["commands_subdir"] == "skills"+ assert AGENT_CONFIG["kimi"]["requires_cli"] is True++ def test_kimi_in_extension_registrar(self):+ """Extension command registrar should include kimi using .kimi/skills and SKILL.md."""+ cfg = CommandRegistrar.AGENT_CONFIGS++ assert "kimi" in cfg+ kimi_cfg = cfg["kimi"]+ assert kimi_cfg["dir"] == ".kimi/skills"+ assert kimi_cfg["extension"] == "/SKILL.md"++ def test_kimi_in_release_agent_lists(self):+ """Bash and PowerShell release scripts should include kimi in agent lists."""+ sh_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.sh").read_text(encoding="utf-8")+ ps_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.ps1").read_text(encoding="utf-8")++ sh_match = re.search(r"ALL_AGENTS=\(([^)]*)\)", sh_text)+ assert sh_match is not None+ sh_agents = sh_match.group(1).split()++ ps_match = re.search(r"\$AllAgents = @\(([^)]*)\)", ps_text)+ assert ps_match is not None+ ps_agents = re.findall(r"'([^']+)'", ps_match.group(1))++ assert "kimi" in sh_agents+ assert "kimi" in ps_agents++ def test_kimi_in_powershell_validate_set(self):+ """PowerShell update-agent-context script should include 'kimi' in ValidateSet."""+ ps_text = (REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1").read_text(encoding="utf-8")++ validate_set_match = re.search(r"\[ValidateSet\(([^)]*)\)\]", ps_text)+ assert validate_set_match is not None+ validate_set_values = re.findall(r"'([^']+)'", validate_set_match.group(1))++ assert "kimi" in validate_set_values++ def test_kimi_in_github_release_output(self):+ """GitHub release script should include kimi template packages."""+ gh_release_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-github-release.sh").read_text(encoding="utf-8")++ assert "spec-kit-template-kimi-sh-" in gh_release_text+ assert "spec-kit-template-kimi-ps-" in gh_release_text++ def test_ai_help_includes_kimi(self):+ """CLI help text for --ai should include kimi."""+ assert "kimi" in AI_ASSISTANT_HELPdiff --git a/tests/test_ai_skills.py b/tests/test_ai_skills.pyindex a040b4bd0..e9bd71d05 100644--- a/tests/test_ai_skills.py+++ b/tests/test_ai_skills.py@@ -410,8 +410,11 @@ class TestInstallAiSkills:skills_dir = _get_skills_dir(proj, agent_key)assert skills_dir.exists()skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]- assert "speckit-specify" in skill_dirs- assert (skills_dir / "speckit-specify" / "SKILL.md").exists()+ # Kimi uses dot-separator (speckit.specify) to match /skill:speckit.* invocation;+ # all other agents use hyphen-separator (speckit-specify).+ expected_skill_name = "speckit.specify" if agent_key == "kimi" else "speckit-specify"+ assert expected_skill_name in skill_dirs+ assert (skills_dir / expected_skill_name / "SKILL.md").exists()