MVCK Premium

指南：把工具包加入你的项目

选一条适合你的路线。两条路线里，最简单的办法都是让 AI 工具来做。

编程新手

你不用输入命令。把一段话粘贴给 AI，然后回答是或否。

新手路线

开发者

你自己运行每条命令。每一步都有可复制的命令和可对照的结果。

开发者路线

新手路线：让 AI 帮你安装

适用于 Cursor、Claude Code、Codex、OpenCode、Grok 和 Kimi。开发者也可以从这里开始。

大白话讲解员

你只做 4 件小事。难的部分交给 AI。

  1. 把下载的两个文件放在“下载”文件夹

    购买后，你会下载两个文件。把它们放在一起。

    minimal-vibe-coding-kit-premium-0.6.6.tgzSHA256SUMS

  2. 在 AI 工具中打开你的项目

    用你正在使用的工具打开项目文件夹。工具包不会替你安装 AI 工具，也不会替你登录。

    • Claude Code
    • Codex
    • Cursor
    • OpenCode
    • Grok
    • Kimi

  3. 把这段话粘贴到 AI 聊天框

    如果文件在别的位置，请修改路径。

    路径 ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz 只是示例。请改成你保存文件的位置。

    如何获取文件的准确路径

    1. 打开文件资源管理器，选中下载的文件。
    2. 按 Ctrl + Shift + C。在 Windows 10 上：按住 Shift，右键单击文件，然后选择“Copy as path”。
    3. 把路径粘贴到示例路径的位置。

    路径大致是这样的：

    C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgz

    在 Windows 上，请把本页命令中的 ~ 换成完整的文件夹路径。

    给 AI 的消息：全新安装

    我购买了 Minimal Vibe Coding Kit Premium。文件位置： ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz 请把工具包安装到当前打开的项目。一次做一步，并告诉我每一步的结果。 1. 计算文件的 SHA-256。与同一文件夹中的 SHA256SUMS 比较。不一致就停止。 2. 解压到 ~/tools/mvck-0.6.6。不要解压到项目里。 3. 进入解压出的 package 文件夹。运行预览： node bin/mvck.js install "<本项目的路径>" --profile all --dry-run --json 告诉我这条命令会添加什么。 4. 等我回答 yes。然后去掉 --dry-run --json 再运行一次。 5. 阅读 .vibekit/init/FIRST_TIME_INIT.md 并初始化项目。给我看建议的 backbone.yml。等我批准后再写入。 6. 在项目中运行工具包的 doctor 和 validate。用简单的话告诉我结果。

  4. 阅读并回答 AI

    AI 会停下来问你两次：把工具包复制进项目之前，以及保存项目规则手册之前。读完后回答 yes。

    正确结果：Validation summary: 0 failures, 0 warnings.

  5. 已经有工具包，想升级到新版本？

    下载新版本，然后粘贴这段话。AI 会先预览改动，备份工具包的旧文件，然后再更新。

    给 AI 的消息：更新

    我下载了 Minimal Vibe Coding Kit Premium 的新版本。文件位置： ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz 当前打开的项目已经有工具包。请更新它。一次做一步，并告诉我每一步的结果。 1. 计算文件的 SHA-256。与 SHA256SUMS 比较。不一致就停止。 2. 解压到 ~/tools/mvck-0.6.6，不要放进项目。 3. 进入新版本的 package 文件夹。运行预览： node bin/mvck.js update "<本项目的路径>" --profile all --dry-run --json 告诉我 fromVersion、toVersion，以及会改动多少个文件。 4. 等我回答 yes。然后去掉 --dry-run --json 再运行一次。 5. 在项目中运行 git status。告诉我哪些文件变了，备份在哪里。 6. 运行工具包的 doctor 和 validate。告诉我结果。

开发者路线：自己运行每条命令

已在 macOS、Node 22 和工具包 0.6.6 上测试。工具包需要 Node 18 或更新版本。

细心工匠

七个步骤。先预览，再写入。

  1. 检查下载的文件

    把输出的字符串与 SHA256SUMS 中的那一行比较。不一致就重新下载。

    路径 ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz 只是示例。请改成你保存文件的位置。

    如何获取文件的准确路径

    1. 打开文件资源管理器，选中下载的文件。
    2. 按 Ctrl + Shift + C。在 Windows 10 上：按住 Shift，右键单击文件，然后选择“Copy as path”。
    3. 把路径粘贴到示例路径的位置。

    路径大致是这样的：

    C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgz

    在 Windows 上，请把本页命令中的 ~ 换成完整的文件夹路径。

    命令
    cd ~/Downloads
node -e "console.log(require('node:crypto').createHash('sha256').update(require('node:fs').readFileSync(process.argv[1])).digest('hex'))" minimal-vibe-coding-kit-premium-0.6.6.tgz
cat SHA256SUMS

    正确结果：两个 64 位字符串完全相同

  2. 解压到单独的文件夹

    让工具包与你的项目分开。package 文件夹里有 bin/mvck.js。

    命令
    mkdir -p ~/tools/mvck-0.6.6
tar -xzf minimal-vibe-coding-kit-premium-0.6.6.tgz -C ~/tools/mvck-0.6.6
cd ~/tools/mvck-0.6.6/package
node bin/mvck.js --help

    正确结果：Minimal Vibe Coding Kit Premium

  3. 预览，先不写入

    把路径改成你的项目。按你的 AI 工具选择 profile，或者用 all。

    Profile：

    点选一项：第 3、4、7 步的命令会随之改变。

    命令
    node bin/mvck.js install "/path/to/project" --profile all --dry-run --json

    正确结果："status": "dry-run"

  4. 安装到项目

    这条命令会立即写入。如果项目已有 CLAUDE.md 或 AGENTS.md，工具包只添加由它管理的区块。

    命令
    node bin/mvck.js install "/path/to/project" --profile all

    正确结果：Install complete:

  5. 初始化项目的规则手册

    在 AI 工具中打开项目，把这段话粘贴到聊天框。AI 会阅读项目，提出 backbone.yml 的建议，然后等你批准。

    给 AI 的消息

    Read .vibekit/init/FIRST_TIME_INIT.md and initialize this project with the kit. Print the requirements you will check. Propose a diff for backbone.yml. Wait for my approval before you write. Summarize in Simplified Chinese.

    正确结果：AI 给出 backbone.yml 的建议，并等你批准

  6. 检查

    在项目文件夹中运行。doctor 报告状态，validate 检查工具包的规则。

    命令
    cd "/path/to/project"
node .vibekit/scripts/mvck.mjs doctor .
node .vibekit/scripts/mvck.mjs validate .

    正确结果：Validation summary: 0 failures, 0 warnings.

  7. 更新到新版本

    下载新版本并解压到单独的文件夹。在新版本的 package 文件夹中运行。被替换的工具包文件会备份到 .vibekit/update-backup/。

    命令
    node bin/mvck.js update "/path/to/project" --profile all --dry-run --json
node bin/mvck.js update "/path/to/project" --profile all

    正确结果：Update complete:

遇到错误时

还是卡住了？给作者发邮件：[email protected]。不要发送密码或密钥。

还没有工具包？

在售版本：v0.6.6。在更新日志里看看有什么新内容。

获取工具包查看更新日志