用途：为 Hindsight 核心产品（API、客户端、CLI、控制平面、Helm）切出正式版本，并单独提交 changelog 与博客 PR。集成组件版本独立，应使用 scripts/release-integration.sh，而非本技能。
主要能力：release.sh 会提升各组件版本、重新生成 OpenAPI 规范与全部客户端 SDK、更新文档版本，提交 Release v<version>、打标签并直接推送到 main，触发 CI 发布包到 PyPI / npm / Helm。随后生成 changelog 条目并手写博客文章，最后创建 PR。
使用方式：先做预检，从最新 origin/main 切出，确认目标修复已合并。在已检出 main 的 worktree 中运行 ./scripts/release.sh <version>（不带前导 v）。验证用 gh run list --limit 5 和 git ls-remote --tags origin v<version>。之后从新 main 建分支 docs-changelog-<version>，运行 uv run --directory hindsight-dev generate-changelog <version>，手写 hindsight-docs/blog/YYYY-MM-DD-version-X-Y-Z.md，运行 ./scripts/generate-docs-skill.sh，再提交并创建 PR。
限制：发布不可逆且对外，会打标签并直接推送 main。不要用 && 管道链执行 checkout。分支名须用 docs- 连字符约定，docs/... 会被拒绝。changelog 的 Database Migrations 段由 git 确定性枚举，不要手改。博客不列集成。需 OPENAI_API_KEY。临时 worktree 用后移除。