SuperAPI AI 工具集

retroactive-uifork

通用与其它

查看项目

更新于 10-16 09:55

技能介绍

用途:UIFork 通常用于向前探索新组件变体,本技能处理回溯场景——工作已作为一串提交落在分支上,希望这段历史在运行中的应用里可浏览:同一路由、同一 props、同一数据,通过 UIFork 组件切换版本,而不是读 git log、原始 diff 或逐个 checkout 提交。适合设计或工程评审 UI 演变、为打磨步骤排序、回顾特性分支的构建过程;不适用于从零草拟新变体(那用 UIFork 本身的工具即可)。

主要能力:把选定的每个提交(外加可选的 BASE 基线)通过 git show <ref>:path 变成真实文件快照,接入 *.versions.ts,标签取自提交主题,使时间线可浏览且有标注。流程分为五个阶段:确定比较基线 BASE(如 main 或 origin/main,可用 git merge-base 校验)、确定目标文件(从 diff 推导并给出稳定的仓库相对路径)、筛选用于时间线的提交、用 UIFork 实现(初始化、创建 v1…vN、填充快照、同步 *.versions.ts、打标签、恢复完整公共导出、根组件挂载)、最后验证(类型检查与手动走查 v1 → vN)。产出还包括一份组件旁的 *.UIFORK-TIMELINE.md,记录用途、哈希、标签和可复现的 git show 命令。

使用方式:需要已具备 UIFork 的使用能力,若未安装可从上游注册表添加:npx skills add sambernhardt/uifork。文中列出了初始化命令示例:pnpm exec uifork init "path/from/app/root/to/Component.tsx" --export ComponentName,以及在添加或重命名版本文件后运行 pnpm exec uifork watch,还可用 pnpm exec uifork rename 重命名版本 id。Next.js App Router 需在应用根挂载 <UIFork />。

限制:资料提醒不要在生产环境向终端用户渲染 <UIFork />,典型做法是在根 UIFork 提供组件中判断生产环境返回 null。基线快照 git show BASE:$TARGET 可能与后续版本在结构、导入、props、导出上差异较大,forked 包装器仍需满足父文件导入的内容,可选薄垫片或从发布版本文件重新导出类型,否则可将基线仅作预览。本技能不适用于生产功能开关或长期 A/B 测试,也不适用于一个 fork 中放多个不相关组件,或无有意义的提交历史可供回放的全新探索。具体价格、收费与更多平台支持信息暂未提供。