用途
MVP Builder Init 用于初始化 MVP Builder 流水线所需的项目环境。智能体、技能和 MCP 服务器本身已随插件提供;该技能负责安装插件无法携带的部分:常驻项目指令、按路径生效的平台规则和权限设置,将脚手架写入当前项目。
主要能力
- 按预设安装平台规则:web 安装 frontend.md、backend.md;mobile 安装 backend.md、mobile.md、ios.md;all 安装全部四个文件。
- 根据当前运行环境区分安装目标:运行于 Claude Code 时安装 CLAUDE.md、.claude/rules/、.claude/settings.json;运行于 Codex 时安装带 Platform Rules 部分的 AGENTS.md、.codex/rules/ 中的规则以及 .codex/agents/ 中的子智能体定义。
- 脚本处理三种情况:全新项目会复制脚手架并写入 .mvp-builder-manifest;已有清单的升级只覆盖用户未修改的文件,已修改文件保留并将新版本以 <file>.new 形式并存;旧版安装(无清单的 .claude/commands、.claude/agents 或旧 CLAUDE.md)会先备份到 .mvp-builder-backup-<timestamp>/,移除被取代的文件后重新安装。
使用方式
调用时通过 $ARGUMENTS 传入规则预设(web、mobile、all)。若为空,技能会在对话中询问“What platform is this project? (web / mobile / all)”并等待回答;仅在用户表示不在意时才默认使用 all。
执行时先在插件内定位安装脚本,检查技能目录上两级的 scripts/install.sh 是否存在,存在则运行:
bash "<this skill's base directory>/../../scripts/install.sh" --platform [platform] --rules [preset] --yes
若未找到(插件布局异常),则从仓库获取安装脚本,注意这会拉取最新发布版本,可能比已安装插件更新:
curl -fsSL https://raw.githubusercontent.com/app-builders-club/mvp-builder/main/scripts/install.sh | bash -s -- --platform [platform] --rules [preset] --yes
脚本的报告(已安装文件、保留文件、.new 文件、备份位置)需原样转达给用户。若生成了 .new 文件,应提示用户手动对比合并,不要自动合并。完成后给出后续步骤:重启会话以加载新的项目指令;在 Codex 上需先在 ~/.codex/config.toml 的 [features] 下启用 multi_agent = true;然后调用 prd 技能定义产品(若 ai-docs/PRD.md 已存在则定义功能)。
错误处理
- 两个位置均找不到安装脚本:报告尝试过的路径和 URL,提示插件安装可能已损坏,建议重新安装插件。
- 脚本以非零状态退出:原样转达错误输出,不做部分修复。
- 用户拒绝脚本转达的迁移提示:停止操作,此时未做任何修改。
适用场景与限制
适用于使用 MVP Builder 插件搭建新项目或升级既有项目配置的开发者。该技能依赖插件目录结构及安装脚本;从仓库回退获取的脚本可能新于已安装插件。安装和升级行为受用户修改文件保护,但需要用户自行处理 .new 文件的合并。