☰
cavekit v3.1.0与v4.0.0如何选?完整对比与“双向门“升级迁移指南
2026/10/15 18:55:22 网站建设 项目流程

【免费下载链接】cavekit

Frozen — compressed spec-driven development plugin for Claude Code. Still works; active development moved to JuliusBrussee/caveman.

项目地址:https://gitcode.com/gh_mirrors/ca/cavekit
点击查看免费下载

cavekit 是面向 Claude Code 的压缩式规格驱动开发(Spec-Driven Development, SDD)插件:v3.1.0 是拥有 16 个命令、12 个命名子代理的完整版,v4.0.0 则是"一个文件、三条命令、零子代理"的重写版。本文用一张对比表 + 六步迁移路径,帮你 5 分钟想清楚:选哪个版本、要不要升级、怎么安全升级。

🧭 30 秒速答:我该选哪个?

你的情况推荐版本
想要完整的自主循环、并行执行、Codex 同行评审v3.1.0
团队对/ck:sketch → /ck:map → /ck:make已有肌肉记忆v3.1.0
项目里有正在持续迭代的context/kits/资产v3.1.0
嫌 v3 太重、经常"和框架打架"v4.0.0
想压缩 token 开销、快速读懂规格v4.0.0
全新项目,想要最精简版本v4.0.0

官方立场很诚实:两个答案都成立。v3.1.0 没有被抛弃,而是"冻结"(frozen)在 tag 上,依然是完整可用的插件(参见 README.md)。

📊 v3.1.0 vs v4.0.0:一张表看懂核心差异

维度v3.1.0v4.0.0
斜杠命令16 个3 个(/ck:spec、/ck:build、/ck:check)
命名子代理12 个0 —— 主 Claude 亲自干活
技能(skills)21 个2 个(caveman、backprop)
规格存放context/kits/目录树仓库根目录单个SPEC.md
工作流Hunt 生命周期(sketch/map/make/check)扁平的 spec → build → check
运行时组件Go 二进制、shell hooks、TS picker无
执行模式自主循环 + stop-hook 状态机原生 Claude Code plan-then-execute
并行执行并行波次 + team 模式刻意单线程
caveman 压缩内部通讯可选开启规格写入默认开启

💡 v4 的核心思想:"规格是唯一配得上它 token 成本的产物"。v3 的 4,977 行命令与代理定义,在 v4 里只剩 226 行。

🔬 v4.0.0 保住了什么?

  • SPEC.md持久规格:六个可寻址章节(§G 目标 / §C 约束 / §I 接口 / §V 不变量 / §T 任务 / §B 缺陷),完整格式定义见 FORMAT.md
  • caveman 压缩编码:符号 + 短语 + 管道表,比散文少约 75% token
  • backprop 反射:每次测试失败都会回写成§B条目,同类 bug 沉淀为§V不变量——协议细节见 skills/backprop/SKILL.md
  • 三条命令各司其职:/ck:spec是规格唯一修改者(commands/spec.md),/ck:build按计划执行并在失败时自动回传缺陷,/ck:check只读漂移报告(commands/check.md)

同时被砍掉的(完整清单见 CHANGELOG.md):13 个命令、全部 12 个子代理、19 个技能、Go 二进制、shell hooks、TS 工具、Codex 评审桥、设计系统工作流、知识图谱集成、并行波次与 team 模式。

🕐 为什么 v3.1.0 仍值得留在手里

v3.1.0 冻结在 tagv3.1.0上,仍可安装、文档齐全,只修关键 bug 不加新功能:

/plugin marketplace add juliusbrussee/cavekit@v3.1.0 /plugin install ck@cavekit

如果你依赖"挂着跑一小时"的自主循环、并行 agent 或 Codex 同行评审,v4 目前没有替代品——官方的建议是留在 v3.1.0,或用 shell 循环自行封装。

🚀 v3.1.0 → v4.0.0 升级迁移六步指南

没有自动迁移工具(v3 的kits/树无法无损映射到单文件SPEC.md),官方推荐路径是"让已构建的代码成为唯一事实来源":

  1. 开分支:git checkout -b v4-migration
  2. 装 v4:npx skills add JuliusBrussee/cavekit,或走 marketplace:/plugin marketplace add juliusbrussee/cavekit后/plugin install ck@cavekit
  3. 提炼规格:运行/ck:spec from-code,v4 会遍历已构建代码生成SPEC.md(不确定处标?让你确认)
  4. 人工校对:用/ck:spec amend §X修正生成结果
  5. 旧资产不丢:context/kits/留在 git 历史里,需要原始推理时git log -- context/kits/即可回溯
  6. 收尾合并:在迁移分支上删除旧目录、提交、择机合并

⚡ 还没写代码(停留在 sketch 阶段)?迁移最轻松:丢掉旧 kit,直接/ck:spec <你的想法>开新规格。

⚖️ 升级后:失去什么,换来什么

你会失去:

  • 自主循环(v4 每次/ck:build只跑一轮 plan-then-execute)
  • 并行执行(刻意单线程,大项目耗时线性增长)
  • Codex 同行评审、设计系统、知识图谱、仪表盘(cat SPEC.md就是仪表盘)

你会换来:

  • 每次调用的上下文占用大幅下降、token 账单更小
  • 30 秒能读完的规格文件
  • 不再纠结"该调用哪个 agent",不再有孤儿状态文件
  • backprop 成为每次构建的默认反射,而非可选项

🚪 是"单向门"吗?——不会,随时可回退

这是官方文档里专门强调的一点:SPEC.md就是纯 Markdown,没有任何锁定机制。如果后来发现 v3 才是对的选择,把SPEC.md重新导出回context/kits/*.md即可;v3 代码也完整保留在 tag 中,git log v3.1.0可看全部提交。详见 UPGRADE.md。

❓ 常见问题

Q1:如何单独安装 v3.1.0?见上文"为什么 v3.1.0 仍值得留在手里"一节的两行 marketplace 命令。

Q2:v3.1.0 会被维护吗?冻结维护:只修关键 bug(issue 用v3标签),不加新功能。

Q3:v4 的规格格式在哪看?FORMAT.md 定义了六个章节、caveman 符号表与管道表规则,是 v4 唯一的"规格说明书"。

Q4:作者现在活跃开发哪里?cavekit 仓库当前以 v4 为准,活跃开发已转移到作者的后续项目 caveman(JuliusBrussee/caveman),但 v4 与 v3.1.0 均可正常使用。

Q5:怎么选?一句话总结。要"编排力"选 v3.1.0,要"克制的核心"选 v4.0.0;而且这是一扇双向门——选错了随时能换。

【免费下载链接】cavekit

Frozen — compressed spec-driven development plugin for Claude Code. Still works; active development moved to JuliusBrussee/caveman.

项目地址:https://gitcode.com/gh_mirrors/ca/cavekit
点击查看免费下载

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询