SuperAPI AI 工具集

starter-kit-upgrade

前端与建站

查看项目

更新于 10-15 18:31

技能介绍

用途:面向已从 laravel/vue-starter-kit、react-starter-kit、svelte-starter-kit 或 livewire-starter-kit 引导并自行定制的项目,帮助用户从上游按“功能”而非“版本”挑选改进,例如提示通知、2FA 自动聚焦修复等。前提是用户代码归自己所有,与上游无共同 git 祖先,因此该技能从当前状态与上游当前状态逐字节比较,不尝试合并历史。

主要能力:八阶段工作流,先识别 kit 类型与分支变体(Fortify/WorkOS × 团队/非团队),再枚举上游最近提交与合并 PR 并按功能聚类,预筛已存在功能,之后让用户显式勾选。应用时对每个文件分类为 new、already-present、differs、deleted-upstream 或 lockfile;自动应用新文件,但定制文件、清单和锁文件一律不自动合并,交由用户决定。每个功能独立提交,保证可回滚。

使用方式:需 git、已认证的 gh、jq 和 bash。核心脚本包括 preflight.sh、fetch_kit.sh、classify_feature.sh、later_edits.sh、apply_new_files.sh、scan_transitive_imports.sh、reconcile_manifests.sh、run_tests.sh。要求工作树干净,全部工作在 starter-kit-upgrade/<short-id> 分支进行,结束后对比基线验证测试/类型检查/构建未被破坏,并输出报告。

限制:不自动解决冲突,不静默覆盖清单或锁文件;主版本框架升级(Laravel 12→13、Livewire 3→4、Inertia v2→v3)不通过该技能处理,需先运行 Laravel Boost MCP 对应命令。若某功能有约 50 个以上差异文件,建议手动升级。默认仅扫描最近 100 条提交/PR,更早功能需翻页。若项目无可用验证命令,会明确说明未做验证。缺失事实暂未提供。