OpenCode与Spec-Kit新版正式发布

虚拟机安装OpenCodeSpec-Kit时遇版本兼容问题：新版OpenCode1 14 28与Spec-Kit不兼容，且新版已移除OpenCode模板。降级方案为OpenCode1 4 7配合specify-cli0 4 1，旧版本组合可完美适配并规避报错。

今天在一台全新的虚拟机上部署 OpenCode Spec-Kit Superpowers 工具组合时，遇到一个非常经典的版本兼容问题，特此记录解决过程。

单独安装 OpenCode 和 Spec-Kit 时均未遇到任何障碍，但一旦将 Spec-Kit 注入项目文件夹，就会弹出第一张图中的错误提示。

此时检查 OpenCode 版本：显示为 1.14.28，而此前正常使用的版本是 1.14.7。

问题的根源在于版本兼容性 —— 最新版 OpenCode 与 Spec-Kit 存在不兼容情况，并且新版 Spec-Kit 已经完全移除了 OpenCode 模板。

1. 将 OpenCode 降级至 1.14.7

最直接的方法是使用官方升级命令进行降级操作：

官方降级方法：opencode upgrade 1.4.7

2. 或者通过 npm 安装指定版本，更加稳定可控

# 先安装npm
sudo apt update && sudo apt install nodejs npm -y
# 安装1.4.7版本
npm install -g opencode-ai@1.4.7
# 验证版本
opencode --version

3. 确认降级是否成功

opencode --version

若输出显示为 1.4.7，则降级成功。✅

但这里有一个容易踩的坑：Spec-Kit 本身也存在版本问题。新版 Spec-Kit 删除了 OpenCode 模板，因此即使你将 OpenCode 降级到旧版，依然无法解决问题。

4. 最终处理方案：同步将 specify-cli 降级到旧版本

uv tool uninstall specify-cli
uv tool install specify-cli==0.4.1

随后再次执行注入命令：

specify-cli new --assistant opencode --script-type sh

查询当前版本：

specify-cli --version

这套工具组合无法直接使用最新版本。目前验证通过的锁定组合为：OpenCode 1.4.7 + specify-cli 0.4.1。该旧版本组合能够完美联动，有效规避模板缺失及版本兼容报错问题。

Superpowers 组件暂未发现异常。