mcpField
T
tenzir-ship

tenzir-ship

github.com/tenzir开发3126 次安装2 天前更新
代码仓库

关于 tenzir-ship

面向使用 tenzir-ship 项目的发布工程技能，指导初始化变更日志和添加条目，并区分触发 CI 的远程发布与本地发布。

主要功能

  1. 01检测变更日志的改动范围
  2. 02初始化变更日志项目
  3. 03添加变更日志条目
  4. 04选择远程或本地发布
  5. 05保留已发布的历史记录

适用场景

  1. 01设置变更日志工作区
  2. 02为待发布的修复或功能记录条目
  3. 03通过 CI 或本地仓库准备发布
  4. 04避免改写已发布的版本说明

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tenzir/skills --skill tenzir-ship

安装后在 Claude Code 中输入/tenzir-ship确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
add-changelog-entry.md
create-local-release.md
create-remote-release.md
init-changelog-project.md
scripts/
detect-change-scope.sh

详细介绍

tenzir-ship

此技能整合了 tenzir-ship 的关键发布工程用例。

更新日志历史

将已发布的更新日志数据视为已发布的历史记录。changelog/releases/ 下的文件（包括发布说明、清单和发布条目文件）一经发布便不可修改，因为它们可能已经存在于 GitHub releases、软件包注册表、文档和下游副本中。

对于常规的后续工作，请在现有历史记录之上添加新的更新日志条目。仅在出现严重的发布缺陷（例如内容存在法律或运营风险）时修改历史发布产物，并且只有在用户明确要求更正时才进行修改。

可用脚本

  • bash <skill-dir>/scripts/detect-change-scope.sh：检测当前更新日志的范围。添加更新日志条目之前，请运行此脚本，以确定应依据暂存、未暂存还是分支更改来编写条目；脚本会输出建议的差异命令和范围内的文件。

用例

初始化更新日志项目

在添加第一条目之前，设置新的更新日志工作区。如果任务是项目设置而非创建条目，请优先使用显式的 init 命令。

说明：references/init-changelog-project.md

添加更新日志条目

在日常开发中发布错误修复、变更和功能时，添加更新日志条目。

说明：references/add-changelog-entry.md

创建发布

我们区分两种发布类型：

  1. 远程：触发 CI 工作流
  2. 本地：从本地仓库发布

如果存在工作流，请优先选择远程发布；否则使用本地发布。

文档

发布过程中遇到错误时，请阅读官方文档以获取更多帮助：

评论

支持 Markdown