kata-whats-new
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese<objective>
Display changes between installed version and latest available version.
Shows version comparison, changelog entries for missed versions, and update instructions.
</objective>
<process>
<step name="get_installed_version">
Read installed version from VERSION file (checking plugin context first):
bash
if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then
cat "$CLAUDE_PLUGIN_ROOT/VERSION" 2>/dev/null
fiIf VERSION file missing:
undefined<objective>
显示已安装版本与最新可用版本之间的变更。
展示版本对比、错过版本的变更日志条目以及更新说明。
</objective>
<process>
<step name="get_installed_version">
从VERSION文件读取已安装版本（优先检查插件上下文）：
bash
if [ -n "$CLAUDE_PLUGIN_ROOT" ]; then
cat "$CLAUDE_PLUGIN_ROOT/VERSION" 2>/dev/null
fi如果VERSION文件缺失：
undefinedKata What's New
Kata What's New
Installed version: Unknown
Your installation doesn't include version tracking.
To reinstall:
/plugin install kata@kata-marketplace
STOP here if no VERSION file.
</step>
<step name="fetch_remote_changelog">
Fetch latest CHANGELOG.md from GitHub:
Use WebFetch tool with:
- URL: `https://raw.githubusercontent.com/gannonh/kata/refs/heads/main/CHANGELOG.md`
- Prompt: "Extract all version entries with their dates and changes. Return in Keep-a-Changelog format."
**If fetch fails:**
Fall back to local changelog:
```bash
cat "$CLAUDE_PLUGIN_ROOT/CHANGELOG.md" 2>/dev/nullNote to user: "Couldn't check for updates (offline or GitHub unavailable). Showing local changelog."
</step>
<step name="parse_versions">
From the remote (or local) changelog:
- Extract latest version - First line after
## [X.Y.Z]## [Unreleased] - Compare with installed - From VERSION file
- Extract entries between - All version sections from latest down to (but not including) installed
Version comparison:
- If installed == latest: "You're on the latest version"
- If installed < latest: Show changes since installed version
- If installed > latest: "You're ahead of latest release (development version?)" </step>
If up to date:
undefined已安装版本： 未知
您的安装未包含版本跟踪功能。
重新安装方式：
/plugin install kata@kata-marketplace
若没有VERSION文件，在此步骤停止。
</step>
<step name="fetch_remote_changelog">
从GitHub获取最新的CHANGELOG.md：
使用WebFetch工具，参数如下：
- URL: `https://raw.githubusercontent.com/gannonh/kata/refs/heads/main/CHANGELOG.md`
- Prompt: "Extract all version entries with their dates and changes. Return in Keep-a-Changelog format."
**如果获取失败：**
回退到本地变更日志：
```bash
cat "$CLAUDE_PLUGIN_ROOT/CHANGELOG.md" 2>/dev/null提示用户："无法检查更新（离线或GitHub不可用）。显示本地变更日志。"
</step>
<step name="parse_versions">
从远程（或本地）变更日志中：
- 提取最新版本 - 之后的第一个
## [Unreleased]行## [X.Y.Z] - 与已安装版本对比 - 来自VERSION文件
- 提取中间条目 - 从最新版本到已安装版本之间的所有版本部分（不包含已安装版本）
版本对比结果：
- 如果已安装版本 == 最新版本："您当前使用的是最新版本"
- 如果已安装版本 < 最新版本：显示自已安装版本以来的变更
- 如果已安装版本 > 最新版本："您的版本领先于最新发布版（是否为开发版本？）" </step>
如果已是最新版本：
undefinedKata What's New
Kata What's New
Installed: 1.4.26
Latest: 1.4.26
You're on the latest version.
**If updates available:**Kata What's New
Kata What's New
Installed: 1.4.23
Latest: 1.4.26
已安装版本： 1.4.23
最新版本： 1.4.26
Changes since your version:
自您当前版本以来的变更：
[1.4.26] - 2026-01-20
[1.4.26] - 2026-01-20
Added
新增
- Feature X
- Feature Y
- 功能X
- 功能Y
Changed
变更
- BREAKING: Changed Z behavior
- BREAKING: 变更了Z的行为
[1.4.25] - 2026-01-18
[1.4.25] - 2026-01-18
Fixed
修复
- Bug in feature A
To update:
/plugin update kata@kata-marketplace
**Breaking changes:** Surface prominently with **BREAKING:** prefix in the output.
</step>
</process>
<success_criteria>
- [ ] Installed version read from VERSION file
- [ ] Remote changelog fetched (or graceful fallback to local)
- [ ] Version comparison displayed clearly
- [ ] Changes since installed version shown (if any)
- [ ] Update instructions provided when behind
</success_criteria>- 功能A中的Bug
更新方式：
/plugin update kata@kata-marketplace
**重大变更：** 在输出中以**BREAKING:**前缀突出显示。
</step>
</process>
<success_criteria>
- [ ] 从VERSION文件读取已安装版本
- [ ] 成功获取远程变更日志（或优雅回退到本地）
- [ ] 清晰展示版本对比结果
- [ ] 显示自已安装版本以来的变更（如有）
- [ ] 当版本落后时提供更新说明
</success_criteria>