SuperAPI AI 工具集

registry-changelog

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:当任务改动了 apps/www/src/registry/** 下用户可见的 Plate registry 输出(UI 组件、节点渲染器、kit、示例、registry 元数据、样式依赖或安装行为)时,用本技能编写并校验 registry changelog 条目。registry-only 工作使用 registry changelog,而非 package changeset;包与 registry 混合改动可能两者都需要。

主要能力:定义 registry changelog 契约,包括何时必须新增条目、何时标记 N/A,以及 MDX 条目的 frontmatter 字段(id、date、status、kind、summary、change、release、diagnostics,legacyRelease 仅用于迁移历史条目)。kind 取 new、fix、behavior、wiring、rename、remove。每条可见 bullet 需用反引号写出真实 registry item id,并可附 entry 元数据注释。

使用方式:源文件位于 apps/www/src/registry/changelog/entries/.mdx,生成产物位于 apps/www/src/registry/changelog/.json,禁止手改生成的 JSON。新建条目:node tooling/scripts/generate-ui-changelog-entries.mjs --new 2026-06-15-fix-editor-wrapping --summary "Fix editor wrapping" --items editor,editor-static --kind fix;重新生成:node tooling/scripts/generate-ui-changelog-entries.mjs --write;校验一致:node tooling/scripts/generate-ui-changelog-entries.mjs --check;改动生成器、schema 或源布局后运行 bun test tooling/scripts/generate-ui-changelog-entries.test.mjs。

适用场景与限制:仅针对用户可见的 registry 变更;测试、内部计划、机械规则改动或纯生成输出可标 N/A。不要写实现日记、测试说明或内部架构理由。收尾需确认源条目存在或记录 N/A 理由、已 --write 更新 JSON、--check 通过,并在包代码变更时单独记录 changeset 决策。其他事实暂未提供。