用途:tenzir-ship 面向 Tenzir 项目的发布工程流程,覆盖新增变更日志条目、编写发布说明、创建发布以及将发布内容发布到 GitHub 等任务,并将这些用例打包为一个技能。
主要能力与使用方式:技能包含脚本 bash <skill-dir>/scripts/detect-change-scope.sh,用于检测当前变更日志范围,在新增条目之前运行,以判断应由暂存、未暂存还是分支变更驱动该条目;脚本会打印建议的 diff 命令及范围内文件。技能区分两类发布:远程发布会触发 CI 工作流,本地发布则从本地仓库发布;存在工作流时优先使用远程发布,否则使用本地发布。项目初始化可参考 references/init-changelog-project.md,新增条目可参考 references/add-changelog-entry.md。
重要约定:changelog/releases/ 下的文件(含发布说明、清单和发布条目文件)一旦发布即视为不可变历史,因为它们可能已存在于 GitHub 发布、软件包注册表、文档及下游副本中;后续工作应在既有历史上新增变更日志条目,仅在出现严重发布缺陷(如法律或运营上不安全的内容)且用户明确要求时,才编辑历史发布产物。
限制与补充:遇到发布流程中的错误时,可查阅官方文档 https://docs.tenzir.com/reference/ship-framework.md 与 https://docs.tenzir.com/guides/packages/maintain-a-changelog.md。资料未提供收费、价格、平台支持范围或具体使用效果等信息。