메뉴
BK-CI 发版 Changelog 增量处理：仅针对本次新增版本块生成「变更概述」并写回中文文件， 再将该增量版本翻译到英文 CHANGELOG。当用户提到发版摘要、变更概述、CHANGELOG 翻译、 中英文 changelog、vX.Y.Z-rc、补充概述、同步英文日志时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
清理长时间未使用的 git worktree（GitHub 版）。仅在用户明确要求清理 worktree 时使用，不自动触发。 关键词：清理 worktree、删除 worktree、移除旧分支、worktree 回收。
在用户显式 @ 本 skill 或明确下达「关闭 worktree 并完成需求」类指令时：将指定分支关联的 GitHub Issue 关闭（可选并确认），移除本地 git worktree 目录与本地分支（不删除远程分支）。 必须在 master 分支上执行。用户可指定要关闭的分支名；若未指定，列出所有 worktree 供用户选择。 不得因仅提及 GitHub、issue、worktree、git 等词而自动套用；须以用户主动调用本工作流为准。
通过 BK-CI 仓库约定安全执行本地提交与远端推送，例如根据当前变更生成一句简短提交内容、先展示给用户确认、确认后再 `git commit`，并默认推送到个人 fork 远端而不是主仓库。 当用户要求“帮我 commit / push / 提交并推送代码 / 发到远端”时优先使用。
通过 GitHub MCP 管理仓库协作时使用，例如检索仓库、提 Issue、起草或创建 PR、查看评论、回复评审和做合并前检查。当用户要操作 GitHub 仓库协作流程而不是修改本地代码实现时优先使用。
须用户 @ 本 skill 或明确说要按 GitHub Issue worktree 流程执行时再读取。 在 master 上：确定关联的 GitHub Issue（默认关联已有，明确要建时才在上游建单）、生成分支名、git fetch、脚本同时创建新分支与 worktree、cursor --new-window 打开新窗口；细节与分支命名见正文。 不因泛泛提到 GitHub、issue、worktree、建分支等词而自动套用。
解释 BK-CI 流水线或创作流的 Model JSON，帮助 AI 理解 Model -> Stage -> Container(Job) -> Element 的含义、启动参数、矩阵、Finally、审核与常见插件语义。用户贴出流水线 JSON、创作流 JSON、编排数据，或询问某个 Stage/Job/插件/atomCode/stepId 含义时使用。
| name | changelog-release-notes |
| description | BK-CI 发版 Changelog 增量处理：仅针对本次新增版本块生成「变更概述」并写回中文文件， 再将该增量版本翻译到英文 CHANGELOG。当用户提到发版摘要、变更概述、CHANGELOG 翻译、 中英文 changelog、vX.Y.Z-rc、补充概述、同步英文日志时使用。 |
用户已完成中文 Changelog 某一版本的明细生成（如 # v4.2.0-rc.4），需要 Agent：
不要替用户从零生成完整 issue 明细；默认假设中文明细已存在。
Changelog 是增量维护的：每次只处理当前新增的那一个版本块。
| 要做 | 不要做 |
|---|---|
只读目标版本块（如 # v4.2.0-rc.4 到下一个 # v... 之前） | 遍历 / 总结整个 CHANGELOG 文件 |
| 只在该版本块内插入「变更概述」 | 修改更旧版本的概述或明细 |
| 只把该版本块翻译并插入英文文件顶部 | 重译或覆盖英文文件里已有历史版本 |
| 语言 | 路径模式 | 示例 |
|---|---|---|
| 中文 | CHANGELOG/zh_CN/CHANGELOG-<major.minor>.md | CHANGELOG/zh_CN/CHANGELOG-4.2.md |
| 英文 | CHANGELOG/en/CHANGELOG-<major.minor>.md | CHANGELOG/en/CHANGELOG-4.2.md |
新版本块通常位于文件顶部 <!-- NEW RELEASE NOTES ENTRY --> 之后，插在旧版本之前。
「本次增量」= 中文文件中目标版本标题到下一版本标题之间的内容：
# v4.2.0-rc.4 ← 增量起点（含）
## 2026-07-16
### Changelog since v4.2.0-rc.3
...明细...
# v4.2.0-rc.3 ← 增量终点（不含）
v4.2.0-rc.4Changelog since ... 读取确认目标版本
↓
【1】定位并只读取该版本增量块
↓
【2】基于该块生成「变更概述」（特性 / Bug）
↓
【3】将概述写回中文文件的该版本块内
↓
【4】仅翻译该增量块为英文
↓
【5】将英文增量块插入英文文件顶部（NEW RELEASE NOTES ENTRY 之后）
↓
完成后简要汇报：概述条数、中英文写入位置
支持按需裁剪：
### 变更概述
当前版本主要变更特性如下:
**特性**
- ...
**Bug 修复**
- ...
对齐 CHANGELOG/zh_CN/CHANGELOG-4.1.md 的「变更概述」：
feat/bug/pref 前缀、不加模块小标题| 优先级 | 判断标准 | 处理 |
|---|---|---|
| P0 | git tag 对比中相近 commit message 提交多；或同主题 Changelog 条目明显集中 | 合并成 1 条主推 |
| P1 | 用户可感知的新能力（触发、复制、变量、商店、环境等） | 单独成条 |
| P2 | API/OpenAPI、渠道过滤、字段补齐、OP 小改 | 默认不进 |
| P3 | 性能、缓存、监控、依赖升级 | 不进 |
同一主题多条必须合并为 1～2 条（用「支持 A、B、C」收束）。
可选辅助命令（只读，用于识别 P0 主题）：
git log --oneline <基线tag>..<目标tag>
按相近 commit message 聚类，提交多的主题优先进入概述。
只保留高影响项，例如：
UI 小问题、边缘场景修复留给明细，不进概述。
# vX.Y.Z-rc.N
## YYYY-MM-DD
### Changelog since vX.Y.Z-rc.(N-1)
### 变更概述 ← 仅插这里
当前版本主要变更特性如下:
...
#### 新增 ← 用户已有明细，禁止改动
不要改动用户已写好的新增 / 优化 / 修复明细。
翻译对象 = 本次中文增量块全文（含刚插入的概述 + 原有明细）。
| 中文 | 英文 |
|---|---|
| 新增 | New Features |
| 优化 | Improvements |
| 修复 | Bug Fixes |
| 流水线 | Pipeline |
| 代码库 | Repository |
| 研发商店 | Store |
| 环境管理 | Environment Management |
| 日志服务 | Log Service |
| 质量红线 | Quality Gate |
| 权限中心 | Permission Center |
| 项目管理 | Project Management |
| 调度 | Dispatch |
| 凭证管理 | Credential Management |
| Agent | Agent |
| 其他 | Others |
| 变更概述 | Summary |
| 特性 | Features |
| Bug 修复 | Bug Fixes |
| 中文 | 英文 |
|---|---|
[新增] | [New] |
[优化] | [Improved] |
[修复] | [Fixed] |
[链接] | [Link] |
### Summary
Key changes in this release:
**Features**
- ...
**Bug Fixes**
- ...
Creation FlowCHANGELOG/en/CHANGELOG-*.md 既有文风一致<!-- NEW RELEASE NOTES ENTRY --> 之后、上一版本之前）