资讯动态

cavekit完整指南:Claude Code规范驱动开发插件,1个文件+3条命令+0个子代理

发布时间:2026/10/15 22:24:54 来源:尧图企业网站定制
【免费下载链接】cavekitFrozen — 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 DevelopmentSDD插件只用1 个 SPEC.md 文件、3 条斜杠命令/ck:spec、/ck:build、/ck:check、0 个子代理让 AI 在长周期开发中记住项目约定。它的核心卖点是caveman 编码比自然语言节省约 75% token和backprop 回传机制——每个测试失败都会沉淀成规范的一部分杜绝同一个 bug 反复出现。为什么需要 cavekit 规范驱动开发普通的先计划、再执行plan-then-execute模式有一个致命弱点会遗忘。上下文一重置AI 就把项目约定忘了。cavekit 的思路非常克制只保留真正有价值的三件事见 README.md持久规范仓库根目录的SPEC.md跨会话存活上下文重置也丢不了caveman 编码用符号、片段、管道表格代替长句token 消耗约为散文的 1/4backprop 反传测试失败 → 记入§Bbug 表 → 提炼成§V不变量规范永远不会忘记踩过的坑作者的理念只有一句话规范是唯一值得花 token 的产物。其余一切开销要么能省下更多 token要么省用户注意力否则就砍掉。快速安装 cavekit 的三种方式 无需编译、无需 Go 二进制、无install.sh三种方式任选其一。方式一通过 skills CLI 一行安装推荐npx skills add JuliusBrussee/cavekit安装后会在~/.claude/skills/下生成 5 个技能工作流三件套spec、build、check加上两个工具技能caveman编码和backprop回传。Claude Code 下次启动自动生效按触发语境激活例如你说write a spec for…就会调起spec技能。方式二通过 Claude Code marketplace 安装/plugin marketplace add juliusbrussee/cavekit /plugin install ckcavekit此方式还会额外注册/ck:spec、/ck:build、/ck:check三条斜杠命令体验更完整。方式三直接 clone 到插件目录git clone https://github.com/juliusbrussee/cavekit.git ~/.claude/plugins/cavekit三种方式装的都是同一个插件版本 4.0.0见 plugin.json只是入口不同。cavekit 三大命令详解/ck:spec、/ck:build、/ck:check三条命令各司其职覆盖了写规范 → 执行构建 → 检查漂移的完整闭环命令职责是否写文件/ck:spec创建 / 修订 / 回传SPEC.md唯一的规范写入者✅ 写/ck:build原生 plan→execute 按规范执行失败时自动 backprop✅ 仅翻转任务状态/ck:check只读漂移报告列出 §V / §I / §T 违规项❌ 纯只读/ck:spec规范的唯一写入者/ck:spec会自动分派到 4 种模式完整逻辑见 commands/spec.mdNEW还没有SPEC.md且参数描述的是一个想法 → 从零生成规范DISTILL还没有SPEC.md且参数带from-code→ 走读现有代码库把已有代码蒸馏成规范BACKPROP参数以bug:开头 → 把 bug 回传进§B表并补充§V不变量AMEND参数以amend开头 → 精准修订你指定的章节绝不悄悄重写未提及的部分/ck:build按规范执行失败不盲目重试/ck:build就是 Claude Code 原生的先计划后执行但多了两个硬约束见 commands/build.md计划必须引用所有相关的 §V 不变量和 §I 接口不能拍脑袋测试失败时先走 backprop 流程再重试——判断是代码 bug、规范错误还是未定义边界对应不同处理方式参数也简单§T.n只跑第 n 个任务--next跑下一个未完成任务--all按顺序跑完全部待办。/ck:check只读漂移报告绝不自动修复/ck:check把SPEC.md与当前代码做 diff见 commands/check.md输出分组报告§V 不变量HOLD成立/ VIOLATE违反/ UNVERIFIABLE无法验证§I 接口MATCH / DRIFT形状不符/ MISSING未实现/ EXTRA代码多出来的§T 任务标为已完成x却找不到代码证据的会被标记为STALE报告最后会附一行补救提示比如VIOLATE → /spec bug: V.n或直接改代码但只提示、不执行——决定权永远在你手里。SPEC.md 六大区块详解caveman 编码如何省 75% token整个 cavekit 的世界就是一个文件仓库根目录的SPEC.md。它由 6 个固定顺序的区块组成格式定义见 FORMAT.md区块名称内容§GGOAL一句话目标代码必须做什么§CCONSTRAINTS不可协商的边界锁定的技术栈、约束§IINTERFACES外部接口CLI、API、配置文件、环境变量§VINVARIANTS编号不变量V1、V2…必须可测试§TTASKS管道表格任务清单状态.待办 /~进行中 /x完成§BBUGS管道表格 bug 日志每行 bug 能抓住它的不变量寻址规则§区块.编号例如§V.2指不变量第 2 条。命令、提交信息、PR 全部用这种地址引用零歧义。caveman 编码是它的压缩语法完整规则见 skills/caveman/SKILL.md删冠词a/an/the、删填充词、删助动词短语可以优先用符号→导致、∀所有、!必须、⊥禁止、≤至多…代码、路径、标识符、数字、错误信息原样保留绝不压缩效果对比散文写法The authentication middleware must verify the token expiry on every request before allowing the handler to execute. caveman 写法V1: ∀ req → auth check before handler规范每次调用都会加载75% 的 token 节省 75% 的费用节省人类扫读也更快。还有两条格式纪律值得注意一个文件规则项目变大就加章节不拆文件超过 500 行先压缩旧 bug和编号单调§V.N、§B.N 永不复用。backprop 回传机制让每个 bug 都成为规范的一部分这是 cavekit 区别于普通 plan-then-execute 的关键完整协议见 skills/backprop/SKILL.md普通模式修好代码然后忘记。 SDD 模式修好代码并且编辑规范让复发变得不可能。这次编辑就叫 backprop。触发时机/ck:build验证测试失败、用户报 bug、生产事故复盘后、/ck:check发现 VIOLATE 且已定位根因。六步流程TRACE追踪定位到精确的 file:line用一句 caveman 话命名根因ANALYZE分析新不变量能抓住这类 bug 吗§I 接口写错了吗§T 任务做偏了吗PROPOSE提案§B行必填§V不变量视情况新增GENERATE TEST生成测试新不变量没有测试 谎言先写失败测试VERIFY验证修代码、跑测试必须通过且不回归LOG记录规范编辑 测试 代码修复一个 commit 提交比如退款任务重试时重复执行的 bug回传结果就是§B 行 B3|2026-04-20|refund job ran twice on retry|V7同时新增不变量V7: ∀ refund → idempotency key check before charge reversal。下一次同类问题出现前规范已经防住了它。如何从 cavekit v3 升级到 v4两条迁移路径cavekit v4 是一次彻底重写详见 UPGRADE.md16 条斜杠命令 → 3 条12 个子代理 → 021 个技能 → 2 个context/kits/目录树 → 单个SPEC.mdGo 二进制和 shell hooks → 全删。v3 没有被弃用——它冻结在 tagv3.1.0依然可以安装、完整可用/plugin marketplace add juliusbrussee/cavekitv3.1.0 /plugin install ckcavekit怎么选项目里有大量活跃的context/kits/投入、依赖自治循环/并行执行/同伴评审 →留在 v3.1.0想要更少活动部件、更低 token 开销或正在开新项目 →上 v4v3 → v4 迁移路径无自动迁移工具官方推荐手动路径切新分支git checkout -b v4-migration安装 cavekit v4运行/ck:spec from-code——已构建的代码才是事实来源走读生成SPEC.md审阅并用/ck:spec amend §X修订旧的context/kits/留在 git 历史里需要时git log -- context/kits/可查信任规范后删除旧目录提交合并作者特别强调这是双向门SPEC.md就是纯 Markdown随时可以反向导出回 v3 的 kits 结构没有任何锁定。cavekit 的设计哲学与文件结构速览v4 的设计哲学很直接LAUNCH-POST.md 里作者的自述v3 的每个功能当初都有理由但堆在一起变成了你得先学会框架才能写规范重写后命令加代理从 4977 行降到 226 行这基本就是原生 Claude Code 加了两个步骤——加的就是规范格式和 backprop 反传。仓库的完整结构一览FORMAT.md 规范 schema caveman 编码规则 commands/ 三条斜杠命令入口spec.md / build.md / check.md skills/spec 规范写入技能对应 commands/spec.md skills/build 计划-执行技能对应 commands/build.md skills/check 漂移报告技能对应 commands/check.md skills/caveman 编码工具技能 skills/backprop bug → 规范回传协议六步对应的技能文档分别在 skills/spec/SKILL.md、skills/build/SKILL.md、skills/check/SKILL.md。明确不做的事non-goals无子代理、无仪表盘cat SPEC.md就是仪表盘、无并行 worker、无 JSON/YAML 规范体、无 hooks 和编排二进制。写在最后适合谁使用 cavekit✅适合想让 AI 在多次会话间保持项目记忆的开发者、token 预算敏感的项目、厌倦了复杂 agent 编排的新手不适合需要长时间无人值守自治循环、多 agent 并行开发、团队模式协作的场景这些是 v3 的能力v4 明确放弃上手只需三步安装 →/ck:spec 你的想法生成规范 →/ck:build开干。版本变更历史可查 CHANGELOG.md。规范驱动开发的核心不是框架有多大而是那份能被反复读取、持续吸收经验的 SPEC.md——这正是 cavekit 全部的价值所在。赞分享【免费下载链接】cavekitFrozen — compressed spec-driven development plugin for Claude Code. Still works; active development moved to JuliusBrussee/caveman.项目地址https://gitcode.com/gh_mirrors/ca/cavekit点击查看免费下载相关推荐claude-howto 插件实战指南用 Claude Code Plugins 把斜杠命令、子代理、MCP 与钩子打包成一条命令claude howto 插件实战指南用 Claude Code Plugins 把斜杠命令、子代理、MCP 与钩子打包成一条命令 本指南以 claude h教程文档从0到1搭建Claude Code Action个人开发者完整指南 从0到1搭建Claude Code Action个人开发者完整指南 Claude Code Action 是一款强大的GitHub Action工具专AI 应用人工智能代码智能体CI/CD代码评审最完整Claude Code插件开发指南从0到1扩展AI助手能力最完整Claude Code插件开发指南从0到1扩展AI助手能力 你是否还在为Claude Code无法满足特定开发需求而苦恼想不想亲手打造专属插件解锁AI文档知识库创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑