Spec-First

Update 指南 ​

入口：/spec:update · $spec-update · 契约见 spec-update

spec-update 用于检查 CLI 版本和项目运行时是否漂移，并在需要时给出修复路径。

参数：[check|repair]

它检查什么 ​

  • 当前安装的 spec-first CLI 版本
  • npm 上最新发布版本
  • 当前项目 .claude/ 或 .codex/ 下的受管运行时是否与发布包同步

为什么它重要 ​

Spec-First 的问题很多不是来自业务逻辑，而是来自运行时资产漂移：

  • CLI 已升级，但项目运行时没重建
  • 宿主入口、skills、agents 和 state 不一致
  • 旧版本运行时资产残留

建议用法 ​

只检查 ​

text
/spec:update check
$spec-update check

检查并修复建议 ​

text
/spec:update repair
$spec-update repair

常见修复动作 ​

在当前源码模型里，最常见的正确修复动作不是手动删缓存，而是重新初始化当前宿主：

bash
spec-first init --claude
spec-first init --codex

如果你怀疑 CLI 本身过旧，再先执行：

bash
npm update -g spec-first