用途：在独立仓库 clickupfy/ 中执行可复现的 ClickUpfy 发布，不手动创建标签或直接改版本。版本、changelog、tag 与 GitHub Release 由 Release Please 决定，制品由 GitHub Actions 在 release 创建后构建发布。
主要能力：按 Conventional Commits 推导版本（fix 为 patch，feat 为 minor，feat! 或 BREAKING CHANGE 为 major；docs、build、ci、refactor 进入 changelog 但不强制提版）；校验发布文档覆盖所有命令、参数、MCP 工具及公开行为，要求 docs/user/ 说明输入、输出、权限、持久化效果、API 限制及每个命令或工具五个不同示例，并核对 docs/user/reading-order.txt 确认章节在 PDF 与 EPUB 中各出现一次；文档变更时确认 ebook/VERSION，执行 npm run ebook、npm run ebook:verify，并发布 manifest 声明的制品；帮助文本变更而无对应手册内容时不得发布。
使用方式：先读 RELEASING.md，检查 git status --short，保留与发布无关的本地改动；依赖未安装时执行 npm ci。提交前运行 npm run validar（校验类型、测试、构建、版本、manifest、changelog 及 workflow 是否存在）。推送 Conventional Commits 到 main，等待 Release workflow 创建或更新 Release PR，在 PR 中审阅版本与 CHANGELOG.md 后合并，并跟踪同一执行产出不可变 tag vMAJOR.MINOR.PATCH、GitHub Release、Linux x64/macOS x64/macOS arm64/Windows x64 可执行文件、npm 包 @promovaweb/clickupfy、同名 .tgz、SHA256SUMS 及公开仓库的 provenance attestations。正常流程不要运行 git tag 或 gh release create。本地可用 npm run release:check 或 npm run release:check -- v0.1.0 校验版本一致性，用 npm run build:executable 构建并测试本平台可执行文件。
限制与恢复：不移动或复用已发布标签；代码错误应发送修复性 Conventional Commit 并发布新的 patch；文件缺失或作业中断时在被打标签的提交上重跑 workflow，上传对同一 release 名称幂等替换；仅在自动化无法恢复且有明确授权时使用 GitHub CLI 手动操作，并在交接中记录原因、标签、替换文件与已执行的校验。发布 PR 缺失、CI 未运行、npm 发布失败等需按 RELEASING.md 检查 workflow 触发与权限、RELEASE_PLEASE_TOKEN、NPM_TOKEN 并重跑失败作业；版本不一致时不要只改单个文件，应检查 package.json、package-lock.json、.release-please-manifest.json、CHANGELOG.md 与标签。