SuperAPI AI 工具集

release-ai-plugins

部署与运维

查看项目

更新于 10-16 06:52

技能介绍

用途:这是 AI Plugins 的高频、可复现发布入口,负责插件版本号、CHANGELOG、三平台清单、README/安装文档同步,以及本地 working tree 到确定性 registry 的生成与校验。发布编排使用同目录 scripts/release-ai-plugins.ps1,默认 DryRun,只有显式 -Apply 才允许写文件。

主要能力:固定输入包括 -Version(MAJOR.MINOR.PATCH)、-Skill(可重复或逗号分隔,省略时按 Git 变更自动发现)、-ChangeType(added/major/minor/patch)、-Summary、-NewSkill、-Apply。脚本只升级本次确实变更的 Skill metadata.version,同步九个 plugin.json 与 Claude/Cursor 两个带版本 marketplace,校验 Codex marketplace 和三个 Codex manifest 专属字段,更新三个 CHANGELOG。ai-plugins/skill-registry.json 的唯一 canonical authority 是 scripts/generate-skill-registry.mjs,PowerShell 入口仅转发 -Check/-Apply。

使用方式:在仓库根目录执行 powershell -NoProfile -ExecutionPolicy Bypass -File ai-plugins/common-tools/skills/release-ai-plugins/scripts/release-ai-plugins.ps1 -Version 10.1.0 -ChangeType minor -Skill release-ai-plugins -Summary "..." -DryRun,确认后追加 -Apply。独立诊断可直接运行 node ai-plugins/common-tools/skills/release-ai-plugins/scripts/generate-skill-registry.mjs --check。

限制:-NewSkill 强制按 patch 升级版本,新技能即使 1.0.0 首发 Apply 后也会变为 1.0.1;若须保持 1.0.0,不要传 -NewSkill。任一脚本失败或验收未通过不得声称发布完成。不负责 commit SHA 解析、Cloudflare KV/R2 发布、Worker 部署、MCP session/cache 或增量 registry 数据库。静态 JSON/schema 校验只是前置门禁,取得真实客户端 CLI 或官方安装验证后才能标记已验证,无法取得证据须记录“未验证”。