用途：这是 kitaru-skills 仓库的发版操作清单。main 是分发分支，用户通过 /plugin marketplace add zenml-io/kitaru-skills 安装 main 上的内容；develop 是工作基线。发版即把 main 快进到 develop 当前提交并写入插件版本号，使 main 始终是 develop 在发版时刻的精确快照。main 受保护规则限制，只有仓库管理员能推送或合并 PR，因此发版由管理员执行，不走 PR、不做强制推送。版本号是本仓库自己的插件版本，不要复用 Kitaru 产品版本号，兼容性写在发布说明里。
前置条件：处于 develop 且工作区干净；已执行 git fetch origin 且本地 develop 与 origin/develop 同步；可快进，即 git merge-base --is-ancestor origin/main origin/develop 返回 0，非 0 说明 main 有 develop 缺失的提交，需排查，绝不强制覆盖。
主要步骤：用 git log --oneline origin/main..origin/develop 查看将发布的内容并据此起草说明；与用户确认下一版本号（新技能或变更用 minor，修复和纯文档用 patch）；把 .claude-plugin/plugin.json 的 .version、.claude-plugin/marketplace.json 的 .metadata.version 与 .plugins[0].version 三处改为同一值，并用 jq 校验可解析且一致；在 develop 上仅提交这两个 JSON 文件，提交信息为 Release vX.Y.Z，然后推送 develop；打标签 git tag vX.Y.Z && git push origin vX.Y.Z；快进 main：git push origin develop:main，禁止 --force；发布说明写入文件后用 gh release create vX.Y.Z --title "vX.Y.Z" --notes-file notes.md 发布，避免内联 --notes 因反引号被 shell 执行；最后用 git ls-remote origin refs/heads/main refs/heads/develop 确认 SHA 一致并检查 Release 页面。
恢复与维护：推送 main 被拒时确认管理员权限并重跑祖先检查；版本写错但未打标签可修正 JSON 后 amend；标签已推送且内容错误，若 Release 未发布可删除重建，否则发后续 patch 版本，不重写历史。本技能的规范副本为 .claude/skills/skills-release/SKILL.md，.agents/skills/skills-release 是指向它的符号链接，只编辑规范文件。