SuperAPI AI 工具集

cli-forge-publish-npm

通用与其它

查看项目

更新于 10-15 20:10

技能介绍

用途:cli-forge 技能族的发布阶段,当生成的 CLI 技能仓库希望为已交付的 CLI 命令增加可选 npm 分发渠道时使用。它不发布 cli-forge 技能族仓库本身,也不替代目标仓库原生的 GitHub Release 工作流,仅在目标仓库发布契约明确后,指导或执行已交付 CLI 命令的 npm 发布。

主要能力:提供三种发布模式——report_only(仅给出 npm 就绪度指导,无副作用)、dry_run(审查包集合并进行打包演练,不声称已发生生产发布)、live_publish(按文档路径发布协调包及所有必需平台包)。

使用方式:先阅读 ./planning-brief.md 锁定 npm 发布契约,再阅读 ./instructions/release/npm-publish-runbook.md 作为操作依据,并确认用户所需模式。需提供目标仓库路径或标识、当前验证状态、已发布技能版本(来自已发布 tag 及 release-evidence.json 等证据)、协调包名、必需平台包名与支持目标、包所有权或注册表访问上下文、面向用户的 npm 安装入口。

适用场景:目标 CLI 技能仓库已完成脚手架且验证为最新,仓库原生发布姿态明确,CLI 调用契约已确定(裸命令名、cargo run -- ...、./target/release/<skill-name> ...),已明确一个协调包与每个支持目标对应的平台包。

限制:npm 发布为可选渠道,仓库原生 GitHub Release 仍是默认发布模型;版本链必须一致(已发布 tag 版本、release-evidence 版本、协调包版本、各平台包版本),否则阻止发布;不得绕过验证或目标仓库上下文检查;不得将跨平台单一二进制包作为必需模型;包所有权不清、平台覆盖缺失或安装指引不明时不得视为可发布。若用户仅需仓库原生发布路径,应回到 ../cli-forge-publish/SKILL.md。