Worktrunk Release Workflow
max-sixty/worktrunk
Walks a maintainer through cutting a Worktrunk release: sync the release branch, pass two test gates, review the changes, then publish.
发版自动化技能：CalVer 版本号 + 从 git log 生成 changelog + GitHub Releases。
Install Release
$ npx skills add 312362115/claude --skill release -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install 312362115/claude release --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/312362115/claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/release .claude/skills/release && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "release" agent skill from https://github.com/312362115/claude/tree/main/skills/release into .claude/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/312362115/claude/tree/main/skills/releaseType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add 312362115/claude --skill release -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install 312362115/claude release --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/312362115/claude.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/release .agents/skills/release && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "release" agent skill from https://github.com/312362115/claude/tree/main/skills/release into .agents/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add 312362115/claude --skill release -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install 312362115/claude release --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/312362115/claude.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/release .cursor/skills/release && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "release" agent skill from https://github.com/312362115/claude/tree/main/skills/release into .cursor/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/312362115/claude.git --path skills/release--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add 312362115/claude --skill release -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install 312362115/claude release --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/312362115/claude.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/release .gemini/skills/release && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "release" agent skill from https://github.com/312362115/claude/tree/main/skills/release into .gemini/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install 312362115/claude releaseInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add 312362115/claude --skill release -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/312362115/claude.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/release .github/skills/release && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "release" agent skill from https://github.com/312362115/claude/tree/main/skills/release into .github/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add 312362115/claude --skill release -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install 312362115/claude release --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/312362115/claude.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/release .opencode/skills/release && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "release" agent skill from https://github.com/312362115/claude/tree/main/skills/release into .opencode/skills/release/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "release", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
release- GitHub stars
- 107
- Token cost
- ~874 tokens
- SKILL.md length
- 126 words
- Files
- 1
- Skills in repo
- 20
- Repo updated
- First seen
- Licence
- MIT
At a glance
发版自动化技能：CalVer 版本号 + 从 git log 生成 changelog + GitHub Releases。
- Works in 3 steps: 通知用户：发版完成，输出版本号和 Release URL → 更新 package.json /… → 提醒：如果有需要手动操作的部署步骤，列出来
- Tasks that involve Changelog and release notes
- SKILL.md covers 第一步：发版前检查, 第二步：确定版本号, 第三步：生成 Changelog and 第四步：创建 Release, plus 3 more sections
- Calls git and gh
What it does
Release is an agent skill from 312362115/claude. 发版自动化技能：CalVer 版本号 + 从 git log 生成 changelog + GitHub Releases。 覆盖完整发版流程：版本号生成→changelog 生成→git tag→GitHub Release（或本地 changelog 文件）。 在发版前自动触发 security-audit 安全审查（如果配置了 CI/CD 则检查 CI 状态）。 触发词：发版、发布、release、生成 changelog、打 tag、版本发布。 触发场景：功能开发完成准备发布、用户主动要求发版、里程碑完成。
Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Changelog and release notes, Security review and CI/CD. It works with GitHub and Git. The licence is MIT.
When your agent uses it
- Tasks that involve Changelog and release notes
- Tasks that involve Security review
- Tasks that involve CI/CD
Example prompts
- “/release”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- 通知用户：发版完成，输出版本号和 Release URL
- 更新 package.json / pyproject.toml（如果项目需要版本号同步到配置文件）
- 提醒：如果有需要手动操作的部署步骤，列出来
What it can do on your machine
Read from SKILL.md and the folder at commit 2d4fa49. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
gitgh
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Release loads about 874 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 126 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from 312362115/claude at commit 2d4fa49, republished under its MIT licence (© 312362115). 126 words, ~874 tokens.
Download SKILL.mdSave it as
.claude/skills/release/SKILL.md (or your agent's skills folder).- name
- release
- description
- 发版自动化技能：CalVer 版本号 + 从 git log 生成 changelog + GitHub Releases。 覆盖完整发版流程：版本号生成→changelog 生成→git tag→GitHub Release（或本地 changelog 文件）。 在发版前自动触发 security-audit 安全审查（如果配置了 CI/CD 则检查 CI 状态）。 触发词：发版、发布、release、生成 changelog、打 tag、版本发布。 触发场景：功能开发完成准备发布、用户主动要求发版、里程碑完成。
- version
- 1.0.0
- last_updated
- 2026-04-08
- repository
- https://github.com/312362115/claude
发版（Release）
发版不只是打 tag，是一个质量门禁流程：安全审查→生成版本→创建 Release。
第一步：发版前检查
发版前必须确认以下条件：
准备发版
│
├─ 1. 代码状态检查
│ ├─ 工作区干净？（无未提交改动）
│ ├─ 在正确的分支上？（main / release branch）
│ └─ 已合并所有需要的 PR？
│
├─ 2. CI 状态检查（如果有）
│ └─ GitHub Actions 全绿？
│
├─ 3. 安全审查
│ └─ 提示用户：是否需要跑 security-audit？（上线服务强烈建议）
│
└─ 4. 测试验证
└─ 核心功能是否经过验证？检查命令：
# 工作区状态
git status
# CI 状态（GitHub）
gh run list --limit 5
# 未合并的 PR
gh pr list任何检查不通过，提示用户处理后再继续，不强行发版。
第二步：确定版本号
CalVer 格式
YYYY.MM.PATCH| 部分 | 含义 | 示例 |
|---|---|---|
| YYYY | 年份 | 2026 |
| MM | 月份（不补零） | 4 |
| PATCH | 当月第几次发布（从 1 开始） | 1, 2, 3... |
版本号生成逻辑：
# 获取当前年月
YEAR=$(date +%Y)
MONTH=$(date +%-m)
# 查找当月已有的最大版本号
LATEST=$(git tag --list "${YEAR}.${MONTH}.*" --sort=-version:refname | head -1)
if [ -z "$LATEST" ]; then
# 当月第一次发布
VERSION="${YEAR}.${MONTH}.1"
else
# 递增 PATCH
PATCH=$(echo "$LATEST" | awk -F. '{print $3 + 1}')
VERSION="${YEAR}.${MONTH}.${PATCH}"
fi
echo "版本号: $VERSION"示例：
- 2026 年 4 月第 1 次发布 →
2026.4.1 - 2026 年 4 月第 2 次发布 →
2026.4.2 - 2026 年 5 月第 1 次发布 →
2026.5.1
第三步：生成 Changelog
从 git log 提取
# 获取上一个 tag 到 HEAD 的所有提交
PREV_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
if [ -z "$PREV_TAG" ]; then
# 没有历史 tag，取所有提交
COMMITS=$(git log --oneline --pretty=format:"%s")
else
COMMITS=$(git log ${PREV_TAG}..HEAD --oneline --pretty=format:"%s")
fi按 type 分组
根据 commit message 的 type(scope): desc 格式自动分组：
# Changelog — v2026.4.1
## 新功能（Features）
- **auth**: 支持 OAuth2 第三方登录
- **export**: 用户数据导出功能
## 修复（Fixes）
- **login**: 修复密码错误时返回 500 的问题
- **cache**: 修复缓存 key 冲突
## 重构（Refactoring）
- **api**: 统一错误响应格式
## 其他
- **docs**: 更新 API 文档
- **test**: 补充登录模块测试用例分组规则：
| commit type | changelog 分组 |
|---|---|
| feat | 新功能（Features） |
| fix | 修复（Fixes） |
| refactor | 重构（Refactoring） |
| perf | 性能优化（Performance） |
| docs, test, chore, ci | 其他（如果没有 feat/fix/refactor 可省略） |
Changelog 输出
- 有 GitHub：嵌入 GitHub Release 的 body
- 无 GitHub：写入
docs/changelog/YYYY-MM-DD-v<版本号>.md
第四步：创建 Release
方式 A：GitHub Release（优先）
# 创建 tag
git tag -a "v${VERSION}" -m "Release v${VERSION}"
git push origin "v${VERSION}"
# 创建 GitHub Release
gh release create "v${VERSION}" \
--title "v${VERSION}" \
--notes "$(cat <<'EOF'
<changelog 内容>
EOF
)"方式 B：本地 Changelog 文件
如果项目不在 GitHub 或不需要 GitHub Release：
# 创建 tag
git tag -a "v${VERSION}" -m "Release v${VERSION}"
# 写入 changelog 文件
# 存入 docs/changelog/YYYY-MM-DD-v<版本号>.md第五步：发版后
- 通知用户：发版完成，输出版本号和 Release URL
- 更新 package.json / pyproject.toml（如果项目需要版本号同步到配置文件）
- 提醒：如果有需要手动操作的部署步骤，列出来
完整发版流程
用户：发个版
│
├─ Step 1: 发版前检查（代码状态 + CI + 安全）
├─ Step 2: 生成版本号（CalVer）
├─ Step 3: 生成 Changelog（从 git log）
├─ Step 4: 创建 Release（GitHub 或本地文件）
└─ Step 5: 发版后处理与其他 skill 的关系
task-finish（功能收尾）
↓
security-audit（发版前安全审查）
↓ 审查通过
release（本 skill — 发版）© 312362115, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/release of 312362115/claude.
Open the folder on GitHubat commit 2d4fa49
Compare with similar skills
Release next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Release this skill312362115/claude | 107 | — | ~874 | Automated safety check: Pass | MIT | |
| Worktrunk Release Workflowmax-sixty/worktrunk | 9k | — | ~6.9k | Automated safety check: Pass | Custom licence | |
| Codex Proxy RS Releasezyycn/codex-proxy-rs | 750 | — | ~327 | Automated safety check: Pass | Apache-2.0 | |
| CI Automationjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~1.4k | Automated safety check: Notes | MIT | |
| Repo SentinelMathews-Tom/armory | 328 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Release Bumpjamiepine/voicebox | 57k | — | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
Codex Proxy RS Release
zyycn/codex-proxy-rs
Plans versions, writes release notes, publishes stable or pre-release builds and recovers from failed releases for Codex Proxy RS, without covering deploys or tag cleanup.
CI Automation
jeremylongshore/tons-of-skills-marketplace
A skill your agent uses when running GitHub Actions locally, creating task runner recipes, generating changelogs from git history, managing GitHub PRs/issues/releases programmatically, or creating…
Repo Sentinel
Mathews-Tom/armory
Full security audit for public repositories across 12 attack surfaces: git history, secrets, CI/CD, containers, dependencies, licenses.
Release Bump
jamiepine/voicebox
Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.
- Official
Go-Redis Release Preparation
redis/go-redis
Prepares a go-redis release locally: picks the next semver, gathers merged PRs, writes the RELEASE-NOTES entry and bumps versions, without publishing.
More from 312362115/claude
All 20 skills in this repoDiagram
312362115/claude
专业图表生成技能：根据需求自动选择合适的图表类型，生成符合设计规范的 PNG 图表. An agent skill from 312362115/claude.
Deep Research
312362115/claude
深度调研技能：对任意命题进行系统性调研并输出专业研究报告. An agent skill from 312362115/claude.
Preview Md
312362115/claude
MD 文件浏览器预览：GitHub 风格渲染 + 左侧自动目录. An agent skill from 312362115/claude.
Writing
312362115/claude
通用写作技能：以"内容→组件→组合"的方式产出技术文档、产品文档、汇报材料. An agent skill from 312362115/claude.
Code Walkthrough
312362115/claude
代码导读技能：帮助快速理解不熟悉的项目或模块，建立心智模型. An agent skill from 312362115/claude.
DB Review
312362115/claude
数据库代码审查 + Migration 安全检查. An agent skill from 312362115/claude.
Related
Categories
Questions about Release
What does Release do?
发版自动化技能：CalVer 版本号 + 从 git log 生成 changelog + GitHub Releases。. Release is an agent skill from 312362115/claude.
When should I use Release?
Release fits situations like: tasks that involve Changelog and release notes; tasks that involve Security review; tasks that involve CI/CD.
How do I install Release in Claude Code?
Run `npx skills add 312362115/claude --skill release -a claude-code`. Or copy the skill folder (skills/release in 312362115/claude) into .claude/skills/release in your project. Claude Code loads it when a task matches its description.
How do I install Release in Codex?
Run `npx skills add 312362115/claude --skill release -a codex`. Or copy the skill folder (skills/release in 312362115/claude) into .agents/skills/release in your project. Codex loads it when a task matches its description.
Can I use Release in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 312362115/claude --skill release -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/release, .gemini/skills/release, .github/skills/release and .opencode/skills/release in your project.
What does Release need to run?
Going by SKILL.md and its folder, Release needs the command-line tools its instructions call (git and gh).
Does Release access the network?
SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Release safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Release use?
Release is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Release use?
About 874 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Release?
Skills that share tags, products or a category with Release: Worktrunk Release Workflow (max-sixty/worktrunk, 9k stars), Codex Proxy RS Release (zyycn/codex-proxy-rs, 750 stars), CI Automation (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Repo Sentinel (Mathews-Tom/armory, 328 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Release?
312362115 (a GitHub user) maintains it in 312362115/claude, which has 107 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on May 14, 2026.
Source: 312362115/claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.