메뉴
Guide a full version release of the simple-sftp VS Code extension. Use when: releasing a new version, bumping version number, tagging a release, publishing to marketplace, creating a GitHub release, writing changelog, or running the release workflow.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | release |
| description | Guide a full version release of the simple-sftp VS Code extension. Use when: releasing a new version, bumping version number, tagging a release, publishing to marketplace, creating a GitHub release, writing changelog, or running the release workflow. |
| argument-hint | （可选）要发布的版本号，例如 6.2.0。若不提供，则自动根据 CHANGELOG.md 和新增功能推断 |
完整发布流程：自动推断版本号 → 更新日志 → 提交 → 打 Tag → CI/CD 自动发布。
VSCE_PATmainmain 已是最新（git pull）直接使用该参数作为新版本号，跳过自动推断。
1. 读取当前版本：从 package.json → "version" 字段获取当前版本号（格式 x.y.z）。
2. 分析 git diff：执行以下命令，获取自上次 tag 以来的所有提交变更内容：
git log $(git describe --tags --abbrev=0)..HEAD --oneline
同时读取 CHANGELOG.md 顶部未发布的条目（若存在），以及当前工作区中已修改但尚未提交的文件列表（git status）。
3. 按以下规则推断递增位：
| 信号 | 递增位 | 说明 |
|---|---|---|
提交信息含 BREAKING CHANGE 或 !: | major X.0.0 | 破坏性变更 |
提交信息含 feat: / feature: 或改动属于新功能（新命令、新配置项、新 UI） | minor x.Y.0 | 新功能（向后兼容） |
提交信息含 fix: / chore: / refactor: / docs: / style: / perf: 或仅为 bug 修复、微调、优化 | patch x.y.Z | 修复 / 微调 |
当同一次发布同时包含多种类型时，取优先级最高的（major > minor > patch）。
4. 推断后向用户展示：告知推断出的版本号及理由，例如：
当前版本
6.7.5，检测到新功能（Export SSH Config 命令增强），推断为 minor 升级 → 新版本6.8.0。
若推断结果不符合预期，用户可在此时提供覆盖值。
遵循语义化版本规则：
| 变更类型 | 递增位 | 示例 |
|---|---|---|
| Bug 修复 / 微调 | patch x.y.Z | 6.1.5 → 6.1.6 |
| 新功能（向后兼容） | minor x.Y.0 | 6.1.5 → 6.2.0 |
| 破坏性变更 | major X.0.0 | 6.1.5 → 7.0.0 |
package.json 并同步 package-lock.json将 "version" 改为新版本号：
"version": "<新版本号>",
然后运行以下命令，让 package-lock.json 中的版本号与 package.json 保持一致（不会安装或升级任何依赖）：
npm install --package-lock-only
为什么需要这一步？
package-lock.json顶部也记录了"version"字段。若两者不一致，CI 中的npm ci可能警告或行为异常，且vsce package打包后扩展信息也会不匹配。
在提交时，将 package-lock.json 一并纳入：
git add package.json package-lock.json CHANGELOG.md
CHANGELOG.md在文件顶部（# Change Log 下方）新增一节，保持现有风格：
## <新版本号> - YYYY-MM-DD
- **Feature/Fix/Enhancement**: 简短描述本次变更。
每条描述保持一行，简洁为主。
npm run test:unit
有失败请先修复再继续。
git add package.json package-lock.json CHANGELOG.md
git commit -m "chore: release v<新版本号>"
git tag v<新版本号>
git push origin main --tags
推送 tag 后，GitHub Actions 的 Release workflow 将自动运行：单元测试 → 打包 → 发布到 Marketplace → 创建 GitHub Release。
需要对已有版本重跑流程时：
package.json 中一致）| 问题 | 解决方法 |
|---|---|
VSCE_PAT 已过期 | 在 Azure DevOps 生成新 PAT（权限选 Marketplace → Manage），更新 GitHub Secret |
| Tag 已存在 | git tag -d v<版本> && git push origin :refs/tags/v<版本>，再重新打 tag |
| CI 测试失败 | 本地执行 npm run test:unit，修复后 amend commit，再 force-push tag |
| 版本号不匹配 | 确保 package.json 中的版本与 tag 名称去掉 v 前缀后完全一致 |