SuperAPI AI 工具集

oss-release-policy

部署与运维

查看项目

更新于 10-23 10:26

技能介绍

该技能将开源发布政策视为一份契约,旨在帮助维护者明确版本号所传达的承诺,界定何为破坏性变更,规划支持版本及回移植窗口,并规范弃用与移除流程。其核心原则包括:版本号应压缩政策而非孤立数字;根据生态系统限制删除不可行选项;仅承诺维护者可投入资源的支持范围。

使用方式:技能通过一问一答的访谈形式收集项目信息,问题涵盖发布物类型、发布渠道、当前版本与方案、依赖者类型、历史破坏案例、维护者每月可投入时间、政策截止日期、是否计划切换方案、追踪的运行时等。若可读取仓库,则从清单、标签和变更日志中自动回答部分问题。访谈后,技能会按步骤引导用户完成映射读者与重大版本成本、选择方案、定义破坏性变更、设计预发布与撤回机制、确定支持版本与回移植策略、设定发布节奏、制定弃用政策,最终生成 RELEASES.md 模板并逐节确认。

主要能力:提供版本方案比较(SemVer、CalVer、Go 语义导入版本等),分析不同生态(npm、PyPI、Cargo、Go)对版本格式的限制与解析行为,帮助评估维护容量与支持线路成本,给出回移植策略建议(仅最新线、上一主版本安全修复、N 个最近线、LTS),并指导撰写预发布命名、撤回触发条件、弃用警告窗口及支持版本表。

适用场景:适用于开源库、SDK、CLI 工具、插件、服务镜像等项目的发布政策制定,尤其适合需要向依赖者提供明确升级预期的维护者,或面临 1.0 发布、方案切换、客户审查等时间节点的项目。

限制:技能依赖用户提供的准确信息,无法自动验证项目实际维护能力;部分建议基于生态惯例(如 Go 版本支持策略),可能不适用于所有项目;未提供具体定价、平台或效果承诺,所有决策需维护者自行确认。