v0.2.2 - 同步 SpecKit v0.0.90

改进

同步升级 SpecKit v0.0.90

• 改进 specify 命令文档格式
• 修复 game.designkit.specify.md 和 game.designkit.specify.toml 中的代码块格式
• 在 git fetch --all --prune 代码块前添加空行，提升 Markdown 可读性
• 保持与上游 SpecKit v0.0.90 的一致性

完整更新日志

查看 CHANGELOG.md 获取完整的版本历史。

v0.2.1 - 全局分支编号策略 (同步 Speckit v0.0.89)

改进

分支编号策略优化

同步 Speckit v0.0.89 的分支编号检测逻辑改进：

场景	旧行为	新行为
已有 dk-005-combat，新建 equipment	从 dk-001-equipment 开始	从 dk-006-equipment 开始

核心变更：

• 分支编号检测从「匹配相同 short_name」改为「获取所有分支/specs 的全局最高编号」
• 避免多人协作时不同功能之间的编号重复问题
• 简化 check_existing_branches() / Get-NextBranchNumber 函数，移除 short_name 参数
• 添加八进制防护：使用 $((10#$BRANCH_NUMBER)) 强制十进制解析，防止 010 被误解为八进制 8

修改的文件

• .game.design/scripts/bash/create-new-feature.sh
• .game.design/scripts/powershell/create-new-feature.ps1

兼容性

• dk- 前缀命名规范保持不变
• 000 全局 spec 逻辑保持不变
• 无需迁移，直接升级即可

v0.2.0 - dk- 前缀命名规范（解决与spec-kit分支名冲突问题）

破坏性变更

• 分支/目录命名规范变更 - 添加 dk- 前缀以避免与 Speckit 冲突
  • 旧格式：000-game-vision, 001-combat-system
  • 新格式：dk-000-game-vision, dk-001-combat-system
  • 更新所有脚本中的正则表达式匹配模式（^([0-9]{3})- → ^dk-([0-9]{3})-）
  • 更新分支名称构造逻辑（7 字符前缀：dk- + 编号 + -）
  • 更新全局规范目录过滤器（000-* → dk-000-*）

修改的文件

• Bash 脚本

  • .game.design/scripts/bash/common.sh - 正则表达式和分支验证
  • .game.design/scripts/bash/create-new-feature.sh - 分支名构造和全局规范检测

• PowerShell 脚本

  • .game.design/scripts/powershell/common.ps1 - 正则表达式和分支验证
  • .game.design/scripts/powershell/create-new-feature.ps1 - 分支名构造和全局规范检测

• 命令文件

  • .claude/commands/*.md - 所有命令中的路径和示例更新
  • .gemini/commands/*.toml - 所有 TOML 格式命令更新

• 模板文件

  • .game.design/templates/spec-template-global.md - 分支占位符和依赖引用
  • .game.design/templates/spec-template-feature.md - 分支占位符和依赖引用
  • .game.design/templates/plan-template.md - 路径约定和规范类型标签
  • .game.design/templates/tasks-template.md - 路径约定

• 文档

  • README.md - 双类型规范描述、目录结构、命令输出、工作流示例
  • README_EN.md - 英文版对应更新
  • CLAUDE.md - 规范类型和目录结构描述

迁移指南

如果您有现有的 gamedesigns 目录，需要手动重命名：

# 示例：重命名现有目录
mv gamedesigns/000-game-vision gamedesigns/dk-000-game-vision
mv gamedesigns/001-combat-system gamedesigns/dk-001-combat-system

v0.1.9 - 修复tasks命令在Gemini CLI下缺少了命令行参数的问题

修复

• Gemini CLI tasks 命令参数占位符 - 修复 game.designkit.tasks.toml 中的参数占位符语法
  • 将参数占位符从 $ARGUMENTS 改为 {{args}}（Gemini CLI 标准语法）
  • 修复2处：用户输入展示区域和任务生成上下文
  • 确保 Gemini CLI 能正确解析和传递命令参数
  • 与其他命令文件保持一致的占位符语法

v0.1.8 - 修复Gemini CLI缺失/game.designkit.tasks命令的问题

修复

• Gemini CLI tasks 命令格式 - 修复 game.designkit.tasks.toml 文件格式问题
  • 添加标准 TOML 格式字段（description 和 prompt）
  • 修正转义语法说明：将 'I'\''m Groot' 改为 'I'\\''m Groot'（双反斜杠转义）
  • 确保 Gemini CLI 能正确解析和执行 tasks 命令
  • 保持与其他命令文件的格式一致性

v0.1.7 - 修复specify命令创建000 spec报错问题

修复

• 全局规范创建命令参数 - 修复 specify 命令创建全局规范时的脚本调用问题
  • 在调用 create-new-feature.ps1/create-new-feature.sh 创建全局型 spec 时，添加 -Number 0/--number 0 参数
  • 确保全局规范始终使用编号 0（000-* 格式），避免自动递增编号
  • 修复文件：.claude/commands/game.designkit.specify.md 和 .claude/commands/game.designkit.specify.toml
  • 保证全局规范（游戏愿景、核心循环等）的命名一致性

v0.1.6 - 修复 Gemini CLI 支持缺少TOML文件的问题

修复

• Gemini CLI 命令格式兼容 - 添加 TOML 格式命令文件支持
  • 为所有 7 个命令添加 .toml 格式文件：analyze、clarify、implement、pillars、plan、specify、tasks
  • 修复 v0.1.5 中 Gemini CLI 无法识别命令的问题（Gemini CLI 要求使用 TOML 格式）
  • 符号链接 .gemini/commands 现在指向包含正确格式的命令文件
  • 确保 Gemini CLI 能正常加载和执行所有命令

v0.1.5 - 添加 Kilo Code, Gemini CLI 支持

新增功能

• Gemini CLI, Kilo Code 支持 - 通过符号链接复用 Claude Code 命令文件
  • 添加 .gemini/commands 符号链接指向 .claude/commands
  • 添加 .kilocode/workflows 符号链接指向 .claude/commands
  • 所有 7 个命令文件自动在 Gemini CLI, Kilo Code 中可用
  • 零维护成本：修改 .claude/commands/ 中的文件自动同步
  • 更新 .gitignore 规则以正确跟踪符号链接目录

v0.1.4 - 命令工作流切换和脚本重构

新增功能

• 命令工作流切换（Handoffs） - 添加命令间无缝切换支持
  • /game.designkit.pillars 可切换到 specify（构造规范）
  • /game.designkit.specify 可切换到 clarify（澄清需求）或 plan（制定计划）
  • /game.designkit.clarify 可切换到 plan（制定计划）
  • /game.designkit.plan 可切换到 tasks（创建任务）
  • /game.designkit.tasks 可切换到 implement（编写文档）或 analyze（分析一致性）
  • 优化工作流体验，减少用户手动切换命令的步骤

改进

• create-new-feature 脚本代码重构 - 同步 Speckit v0.0.85 改进
  • 新增 get_highest_from_specs() / Get-HighestNumberFromSpecs 函数：从 gamedesigns 目录提取最高编号（跳过 000）
  • 新增 get_highest_from_branches() / Get-HighestNumberFromBranches 函数：从所有 git 分支获取最高编号
  • 新增 clean_branch_name() / ConvertTo-CleanBranchName 函数：统一分支名称清理逻辑
  • 修复 SCRIPT_DIR 设置：添加 CDPATH="" 防止路径解析错误
  • 修改 check_existing_branches() / Get-NextBranchNumber 函数：添加 gamedesigns_dir 参数以支持目录路径传递
  • 重构内联逻辑为可复用函数，提高代码可维护性和可测试性
  • Bash 和 PowerShell 脚本保持一致的代码结构

v0.1.3 - 命令优化与跨平台规范化

改进

• /game.designkit.plan 命令优化 - 澄清 Phase 1 设计产物规划流程
  • 明确 Phase 1 是规划产物而非实际生成文档
  • 强调在 plan.md 中定义产物的目的、结构、内容来源和输出路径
  • 实际策划案文档（gameplay-design.md、numerical-framework.md 等）由 tasks 命令安排，implement 命令编写
  • 提升命令责任边界清晰度，避免规划与执行阶段混淆

修复

• 跨平台换行符规范化 - 确保所有文本文件使用一致的换行符
  • 添加 .gitattributes 文件配置 LF 换行符为标准格式
  • 禁用 Git autocrlf 配置，避免 Windows/Linux/MacOS 跨平台差异
  • 应用换行符规范化到所有命令文件（analyze/clarify/implement/plan/specify/tasks）
  • 确保 Shell 脚本（.sh）和 PowerShell 文件（.ps1）在所有平台正常执行