SuperAPI AI 工具集

sync-plate-ui

通用与其它

查看项目

更新于 10-16 08:09

技能介绍

用途:把本仓库的 Plate UI 注册表组件同步到下游应用,同时不抹平该应用的产品分叉。与 sync-shadcn 不同,它比较的是 Plate UI 注册表源码与复制并定制过 Plate UI 的目标应用(例如 ../potion)。该技能仅在消费端使用,读取已生成的 Plate UI changelog JSON,不创建上游条目。

主要能力:读取 Plate 注册表源码、生成的 changelog JSON 和下游本地文件;按 hunk 或符号级别分类上游所有与目标所有的变更(upstream-only、local-only、same-change、conflict、local-delete、rename-map、unknown-base);写出可评审的产物(plan.md、inventory.json/md、component-diffs.md、target-files.txt、decision-counts.json、dashboard.json/md);在 apply 模式仅应用被接受的同步行。决策标签包括 pull-upstream、keep-fork、smart-merge、reject-upstream、delete-target-residue、package-only、needs-question、no-op。

使用方式:命令有 status、plan、review、dashboard、apply。示例:sync-plate-ui ../potion code-block-node、sync-plate-ui plan ../potion code-block-node、sync-plate-ui status ../potion、sync-plate-ui apply ../potion。省略目标仓库且无法从当前目录推断时,会追问一个问题。规划模式为默认,只读目标仓库并写目标 .plate-ui-sync/**,不得改动目标源码;仅在后续用户消息接受具名计划、仪表盘负载、组件或行后才进入 apply 模式。依赖 autogoal,写入状态、运行产物、仪表盘或实现改动前须先加载。启动模板:node .agents/skills/autogoal/scripts/create-goal-scratchpad.mjs --template sync-plate-ui --title "sync plate ui <target> <scope>"。

适用场景:把 Plate UI 注册表修复同步到复制并定制过 Plate UI 的下游应用,如 Potion 类目标(src/registry/** 下复制文件、src/components/** 包装、固定版本 @platejs/* 与 platejs)。

限制:无信任基线时进入引导规划并停止,不得凭推测重建分叉归属;不得运行 build:registry,不得编辑生成的注册表输出;规划模式不得补丁目标源码、更新包或锁文件、标记组件已应用、把建议当作用户接受;无直接微合并例外,精确匹配的上游专属文件可在 apply 模式无需逐 hunk 复核应用,但规划仍先记录该行;不持久化 .patch 文件;若组件 changelog 仅有散文,则记为阻塞并回退到源码差异加用户显式接受。验证命令与包管理器命名等更多细节暂未提供。