vibestart

VibeStart CLI

使用 CLI 解析技术栈并维护生成的项目。以 CLI 当前的帮助信息、功能列表和变更计划为准，确定支持的功能；不要自行重建模板或手动编辑项目记录。

建立上下文

1. 确定目标目录，以及请求是创建项目还是维护项目。阅读项目说明。对于现有项目，检查 vibestart.jsonc（其中的 name、version 和选项）、package.json 和 Git 状态。保留无关的编辑内容。
2. 通过 npm 运行 CLI：npx --yes vibestart-cli（或 pnpm dlx vibestart-cli）；无需全局安装。使用 npx --yes vibestart-cli --version 确定其版本。若先预览再应用，请在两条命令的包名后追加 @ 和确切的已发布版本，以免新版本改变目标。
3. 安装此技能不会安装 CLI、Vite+ 或项目依赖。如果缺少必需的工具，请按照其安装说明，在用户授权的范围内进行安装，而不是更改所选技术栈。
4. 创建项目时阅读 npx --yes vibestart-cli --help，维护项目时阅读 npx --yes vibestart-cli COMMAND --help。对于由 Agent 执行的操作，优先使用 --json；将标准输出与标准错误分开。不要将任务运行器的横幅解析为 JSON。

选择工作流

操作前先阅读相关参考文档。路径相对于此技能所在目录，而非用户的项目目录。

用户意图	首要操作	参考文档
创建项目或使用配方	npx --yes vibestart-cli --list --json	创建项目
添加功能	npx --yes vibestart-cli add --list --json	维护
诊断现有项目	npx --yes vibestart-cli doctor --offline --json	维护
更新生成的项目	npx --yes vibestart-cli upgrade --dry-run --json	维护
完成写入：冲突、手动更改、检查	阅读写入操作的 JSON 结果和 git diff	维护

从生成的项目根目录运行维护命令，或传入 --cwd /actual/project/path。创建项目则使用位置参数指定目标目录；该命令没有 --cwd 选项。

在请求范围内执行

• 写入前先预览更改。用户已请求执行操作，且计划符合请求范围时，直接继续，无需再次征求许可。只有缺少产品选择，或涉及请求范围之外的重大变更时才询问。请求检查或预览并不授权应用计划。
• 创建时使用 --json 禁用提示。维护性写入还需要 --yes。创建时不要传入 --yes。
• 维护性写入要求 Git 工作区干净。如果工作区中有用户尚未提交的工作，写入前应询问是否提交或暂存。
• 包管理器和 Hono 运行时是两个独立的选择：--package-manager bun 用于选择依赖安装方式；--runtime bun 用于选择 Hono 执行方式。两者互不影响，也不会将 Vite+ 测试工具链迁移到 Bun。不要用 bun test 替换 vp test，也不要强制 CLI 在 Bun 下运行。
• 现有项目使用 add 和 upgrade。只能通过这些命令更改选项；保留 CLI 写入的 vibestart.jsonc 中的 name 和 version，因为升级会根据它们重新生成原始模板。
• 遵守环境的安装和服务限制。常规创建和维护写入会运行设置/检查。如果这些操作不可用，请使用只读预览；如果写入文件在请求范围内，也可以明确延后安装。--full-check 可能会启动服务和浏览器。

报告实际结果

说明 CLI 版本、目标项目、所选更改、返回状态、实际运行的检查，以及任何待处理事项，包括冲突和仍需移植的 manual 更改。对于机器输出，同时检查退出代码和 JSON 字段。预览成功、doctor 结果或历史堆栈验证记录，都不能证明此项目的测试已通过。即使退出代码为零，needs-install 也表示操作尚未完成。

后续工作使用项目生成的任务：vp install、vp check，以及 package.json 或 vite.config.ts 中存在的任务。vp run ready 会运行完整的项目验证链。可选功能不可用时，不要假设相应任务存在。生成器仓库中的 vp run deps update 是维护者命令，不是生成项目的升级命令。