关于 release
用于发布 @m1heng-clawd/feishu 新版本的工作流指南,面向维护者,按步骤涵盖版本判断、类型检查、GitHub Release 和 npm 发布。
主要功能
- 01确定版本升级类型
- 02运行 TypeScript 类型检查
- 03编写并创建 Release 草稿
- 04更新 package.json 版本
- 05推送提交与 Git 标签
- 06发布 npm 包和 GitHub Release
适用场景
- 01发布补丁、次要或主要版本
- 02发布前检查类型错误
- 03处理 npm 认证或标签问题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ m1heng/ clawdbot-feishu --skill release安装后在 Claude Code 中输入/release确认已加载。
详细介绍
发布工作流
将 @m1heng-clawd/feishu 的新版本发布到 npm,并创建 GitHub 发布。
前提条件
- 工作树干净(所有更改都已提交到
main) npm login会话已激活,且拥有@m1heng-clawd作用域的发布权限ghCLI 已完成身份验证
步骤
1. 确定版本升级类型
检查自上次发布以来的更改:
# Find latest release tag
gh release list --limit 1
# Review commits and diff stat
git log <last-tag>..HEAD --oneline
git diff <last-tag>..HEAD --stat
选择升级类型:patch(错误修复)、minor(新功能)或 major(重大更改)。
2. 类型检查
npx tsc --noEmit
如果类型检查失败,请勿继续。
3. 起草发布说明
检查完整差异,编写发布说明:
git diff <last-tag>..HEAD
先创建 GitHub 发布草稿:
gh release create v<new-version> --draft --title "v<new-version>" --target main --notes "<release notes markdown>"
4. 更新 package.json 中的版本
编辑 package.json,将 "version" 字段更新为 <new-version>。
5. 提交、打标签并推送
git add package.json
git commit -m "chore: bump version to <new-version>"
git tag v<new-version>
git push && git push --tags
6. 发布到 npm
npm publish
如果身份验证失败,请让用户先运行 npm login,然后重试。
7. 发布 GitHub 发布
gh release edit v<new-version> --draft=false
发布说明格式
遵循既定格式(可参考以往的发布说明):
## Features
- **Feature title** — Description. (#PR)
## Bug Fixes
- **Fix title** — Description. (#PR)
## Internal
- Internal change description.
故障排查
npm publish 出现 404 / 身份验证错误
npm login # re-authenticate
npm whoami # verify logged in
npm publish # retry
标签已存在
如果标签已创建但发布失败,请在修复问题后删除并重新创建:
git tag -d v<version>
git push origin :refs/tags/v<version>
# fix issue, then re-tag and push
评论
支持 Markdown