メニュー
为 zentao-api 准备并可选发布新版本：检查 Git 状态，分析上个 tag 以来的变更，按 SemVer 确认版本号，更新 package.json 与 CHANGES.md，重新生成和构建文档，运行发布验证，创建发布提交与 Git tag，并在明确授权后发布到 npm。用户提出发布版本、准备 release、升级版本号、整理变更日志并打 tag，或发布 npm 包时使用。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/easysoft/zentao-api --skill releaseコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
评审 zentao-api 代码变更，优先使用用户指定范围；未指定时评审本地未提交内容，工作区干净时评审相对 upstream 的全部未推送提交。用户要求代码评审、审查改动、检查提交质量、评估是否可以合并，或查找回归与风险时使用。
处理 zentao-api 的 OpenAPI 与模块注册库更新：比较 operation 契约和示例变化，维护 zentao-api-map.json 的模块、action 名称及 ModuleAction 属性映射，解决命名冲突，核对 GET resultGetter，审计每个非 Token operation 的直接或合并覆盖，并重新生成验证 src/modules/generated.ts。用户提出更新 OpenAPI、同步注册库、重新生成模块定义、处理 action 冲突或结果字段、检查 zentao-openapi.json 差异及报告接口变化时使用。
| name | release |
| description | 为 zentao-api 准备并可选发布新版本：检查 Git 状态，分析上个 tag 以来的变更，按 SemVer 确认版本号，更新 package.json 与 CHANGES.md，重新生成和构建文档，运行发布验证，创建发布提交与 Git tag，并在明确授权后发布到 npm。用户提出发布版本、准备 release、升级版本号、整理变更日志并打 tag，或发布 npm 包时使用。 |
从仓库根目录执行流程，遵守项目 AGENTS.md，仅使用 Bun 管理依赖和运行项目脚本。尊重用户指定的执行范围；用户要求完整发布时，执行下述本地准备流程。不要擅自丢弃已有改动、推送远端或发布 npm 包。
git rev-parse --show-toplevel，确认正在操作 zentao-api 仓库根目录。git status --short --branch，记录分支和工作区状态。git describe --tags --abbrev=0 获取最近 tag。没有 tag 时，以全部历史为范围。git log <最近-tag>..HEAD --oneline；没有 tag 时运行 git log --oneline。package.json 的当前版本，并检查 CHANGES.md 的既有格式和措辞。package.json 使用裸版本号，tag 使用 v<版本号>。feat、fix 等提交前缀；以代码和用户可见行为为准。v<版本号> 不存在；如版本或 tag 已存在，停止处理冲突。仅修改 package.json 的 version 字段，不手工修改 src/version.ts；构建脚本会从 package.json 注入 VERSION。
在 CHANGES.md 的 # 变更日志 标题后插入最新条目：
## <版本号> - <YYYY-MM-DD>
### 新增
- ...
### 修复
- ...
### 变更
- ...
### 测试
- ...
### 文档
- ...
只保留有实际内容的分类。使用简洁中文描述用户影响，合并重复提交，忽略纯发布 housekeeping，并沿用现有日志风格。
不手工编辑 docs/reference/ 或 docs/zentao-api/ 的生成文件。
依次运行：
bun run docs:generate
bun run docs:build
bun run check
要求所有命令成功。bun run check 中的构建和 smoke test 必须确认导出的 VERSION 与 package.json 一致。命令失败时先诊断并修复根因，不要创建发布提交或 tag。
随后检查 git status --short 和完整 diff：
package.json、CHANGES.md 和生成的 docs/ 变更正确。git add package.json CHANGES.md docs。git diff --cached --check，再检查暂存 diff 和统计；有错误或意外文件时先处理。git commit -m "* release v<版本号>"。git tag v<版本号> 创建 tag。git push && git push --tags。只有用户明确要求或确认发布 npm 包后才继续。需要认证时运行 npm login，随后运行：
bun publish
发布成功后报告 zentao-api npm 包；发布失败时保留本地提交和 tag，说明失败步骤，不重复发布或改写版本历史。