mcpField
C
clickupfy-release

clickupfy-release

github.com/promovaweb云与 DevOps459 次安装3 天前更新
代码仓库

关于 clickupfy-release

此 Skill 用于 ClickUpfy 仓库的发布流程。它通过 Release Please 管理版本和发布信息，再由 GitHub Actions 构建并发布产物，同时检查用户文档和流程的可复现性。

主要功能

  1. 01使用 Conventional Commits 作为发布输入
  2. 02校验版本与发布元数据
  3. 03通过 GitHub Actions 构建平台可执行文件
  4. 04发布 npm 与 GitHub Release 产物
  5. 05检查电子书文档及生成文件

适用场景

  1. 01发布前准备并校验变更
  2. 02审查并合并 Release PR
  3. 03诊断发布构建或发布失败
  4. 04恢复发布且不复用已有标签

安装

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

$npx skills add https://github.com/promovaweb/clickupfy --skill clickupfy-release

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

附带文件agents/openai.yaml

详细介绍

ClickUpfy 发布

在不手动创建标签或更改版本的情况下，执行可复现的发布流程。 Release Please 是版本、变更日志、标签和 GitHub Release 的来源。GitHub Actions 会在创建 release 后构建并发布构件。

发布的文档覆盖范围

检查 docs/user/ 中是否说明了该版本的所有命令、参数、MCP 工具和公开行为。手册必须详细介绍输入、 输出、权限、持久化影响、API 限制，以及每个命令或工具的五个不同示例。另请阅读 docs/user/reading-order.txt，确认每个章节在 PDF 和 EPUB 中都只出现一次。

如果文档有更改，请确认 ebook/VERSION， 执行 npm run ebook，执行 npm run ebook:verify，并发布最终清单中声明的构件。如果帮助文本有更改，但手册中没有相应说明，请勿发布该版本。

开始之前

  1. 在独立仓库 clickupfy/ 中操作。
  2. 阅读 RELEASING.md 并检查 git status --short。
  3. 保留与发布无关的本地更改。
  4. 如果尚未安装依赖，请执行 npm ci。
  5. 除非获得明确授权进行恢复，否则不要创建标签或直接编辑版本。

准备更改

使用 Conventional Commits。Release Please 根据自上次发布以来的历史记录确定下一个版本：

  • fix: 提议 patch 版本；
  • feat: 提议 minor 版本；
  • feat!: 或 BREAKING CHANGE: 提议 major 版本；
  • docs:、build:、ci: 和 refactor: 会纳入变更日志，但不会强制升级到高于现有功能更改所需的版本。

提交更改前：

npm run validar

该命令会检查类型、测试、构建、版本、清单、变更日志和工作流是否存在。

发布版本

  1. 将 Conventional Commits 推送到 main。
  2. 等待 Release 工作流创建或更新 Release PR。
  3. 在 PR 中检查提议的版本和 CHANGELOG.md。
  4. 合并 Release PR。
  5. 跟进同一次工作流运行，直到出现以下结果：
    • 不可变标签 vMAJOR.MINOR.PATCH；
    • GitHub Release；
    • Linux x64、macOS x64、macOS arm64 和 Windows x64 的可执行文件；
    • 发布到 npm registry 的包 @promovaweb/clickupfy；
    • 同一个 npm 包以 .tgz 文件形式附在 GitHub Release 中；
    • SHA256SUMS；
    • 仓库公开时提供来源证明。

正常流程中不要运行 git tag 或 gh release create。

本地验证

验证当前版本的一致性：

npm run release:check
npm run release:check -- v0.1.0

第二条命令只能使用与当前版本对应的标签。生成并测试本地平台的可执行文件：

npm run build:executable
./artifacts/clickupfy-v0.1.0-linux-x64/clickupfy --version

根据脚本显示的版本、平台和架构，调整构件名称。

诊断故障

  • Release PR 缺失：检查工作流触发条件、Actions 权限，以及 bootstrap-sha 或上一个标签之后是否有 Conventional Commits。
  • Release PR 上未运行 CI：按照 RELEASING.md 配置可选 secret RELEASE_PLEASE_TOKEN。
  • 已创建 Release 但没有二进制文件：重新运行同一次工作流运行中失败的作业。
  • npm 发布失败：确认 secret NPM_TOKEN，然后重新运行作业；该脚本会跳过 registry 中已存在的版本。
  • 构件无效：在受影响的平台上使用 npm ci、npm run validar 和 npm run build:executable 重现问题。
  • 版本不一致：不要只修正一个文件。检查 package.json、package-lock.json、.release-please-manifest.json、 CHANGELOG.md 和标签。

恢复一个发布版本

不要移动或重复使用已发布的标签。如果代码有误，请提交修正性的 Conventional Commit 并发布新的补丁版本。如果缺少文件或任务中断，请在已打标签的提交上 重新运行工作流；上传操作会对同一发布版本中的文件名进行幂等替换。

仅当自动化无法恢复且已获得明确授权时，才使用 GitHub CLI 手动操作。 请在交接记录中注明原因、标签、已替换的文件以及执行的验证。

评论

支持 Markdown