release
Installation
SKILL.md
发布 zentao-cli
从仓库根目录执行流程并遵守 AGENTS.md。尊重用户指定的执行范围;用户要求完整发布时,完成本地发布准备、提交和 tag。不要擅自丢弃既有改动、推送远端或发布 npm 包。
1. 检查发布前状态
- 运行
git rev-parse --show-toplevel,确认正在操作zentao-cli仓库根目录。 - 运行
git status --short --branch,记录当前分支和工作区状态。 - 如存在未提交或未跟踪文件,列出文件并暂停;请用户先提交、暂存或明确哪些改动应纳入发布。不要自行暂存、覆盖或丢弃它们。
- 读取
package.json的当前版本,并确认对应的v<当前版本>tag 与发布历史没有明显冲突。
2. 收集版本和变更范围
- 运行
git describe --tags --abbrev=0获取最近 tag。没有 tag 时,以全部历史为发布范围。 - 有 tag 时运行
git log <最近-tag>..HEAD --oneline;没有 tag 时运行git log --oneline。 - 同时检查提交正文、
git diff --stat、git diff --name-status和必要的源码差异。不要只根据提交标题判断用户影响或破坏性变更。 - 如最近 tag 后没有实际变更,停止并说明没有内容可发布。
- 读取
CHANGES.md顶部和最近版本条目,沿用既有结构、分类和中文措辞。 - 收集发布范围内
skills/下的变更文件,并归并到各顶层技能目录。没有 tag 时,将当前所有随包技能视为首发范围。.agents/skills/是项目开发技能,不属于随 npm 包发布的skills/,不要同步其版本号。