Agent skill

Release Ops

by oce-ai in oce-ai/oce

OpenContextEngine (oce) 仓库的版本发布运营技能。使用 scripts/ 下的 bumpversion.py 更新版本号(pyproject.toml 与 src/oce/init.py 同步)、generatechangelog.py 从 git 提交生成 CHANGELOG、release.py 执行 bump→changelog→build→commit→tag…

Apache-2.0Auto-check passedDevelopment

Install Release Ops

skills CLI
$ npx skills add oce-ai/oce --skill release-ops -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oce-ai/oce release-ops --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oce-ai/oce.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/release-ops .claude/skills/release-ops && rm -rf skills-src

Use ~/.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/

Facts

Skill name
release-ops
GitHub stars
121
Token cost
~627 tokens
SKILL.md length
214 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

OpenContextEngine (oce) 仓库的版本发布运营技能。使用 scripts/ 下的 bumpversion.py 更新版本号(pyproject.toml 与 src/oce/init.py 同步)、generatechangelog.py 从 git 提交生成 CHANGELOG、release.py 执行 bump→changelog→build→commit→tag…

  • Works in 6 steps: 确认目标版本:读 pyproject.toml… → 检查工作区:git status --porcelain… → 演练:uv run python scripts/release.py <目标>… → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers 版本号事实来源, 命令速查, 标准发布流程(AI 执行步骤) and 约束(必须遵守)
  • Calls uv and git

What it does

Release Ops is an agent skill from oce-ai/oce. OpenContextEngine (oce) 仓库的版本发布运营技能。使用 scripts/ 下的 bumpversion.py 更新版本号(pyproject.toml 与 src/oce/init.py 同步)、generatechangelog.py 从 git 提交生成 CHANGELOG、release.py 执行 bump→changelog→build→commit→tag 全流程。当用户要求"更新/提升版本号"、"生成 CHANGELOG / 变更日志"、"发版 / 发布 / release"、"打 tag"、"准备发布"、"bump version"时使用。执行写操作前必须先 dry-run 预览并展示给用户,禁止自动 push。

Its SKILL.md is about 630 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. It works with Git and Python. The repository describes itself as: OpenContextEngine is a self-hosted, ACE-compatible code retrieval service. It indexes source files with cAST-aware chunking, stores metadata in PostgreSQL or SQLite, performs… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “更新/提升版本号”
  • “生成 CHANGELOG / 变更日志”
  • “发版 / 发布 / release”
  • “/release-ops”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 确认目标版本:读 pyproject.toml 当前版本;若用户只说"升个版本",按语义选 patch(修 bug)/ minor(新功能)/ major(破坏性)。
  2. 检查工作区:git status --porcelain 必须为空(release.py 会自动拦截,并会因未跟踪文件中止)。
  3. 演练:uv run python scripts/release.py <目标> --dry-run,把计划展示给用户确认。
  4. 执行(确认后):uv run python scripts/release.py <目标>。
  5. 验证:git log -1 --oneline、git tag -l、git status --porcelain 干净。
  6. 收尾提示:push 与 uv publish 保持手动,脚本不自动执行,提醒用户即可。

What it can do on your machine

Read from SKILL.md and the folder at commit d1f5493. 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:

    • uv
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv and git, 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 Ops loads about 627 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 214 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~627

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 oce-ai/oce at commit d1f5493, republished under its Apache-2.0 licence (© oce-ai). 214 words, ~627 tokens.

Download SKILL.mdSave it as .claude/skills/release-ops/SKILL.md (or your agent's skills folder).
name
release-ops
description
OpenContextEngine (oce) 仓库的版本发布运营技能。使用 scripts/ 下的 bump_version.py 更新版本号(pyproject.toml 与 src/oce/__init__.py 同步)、generate_changelog.py 从 git 提交生成 CHANGELOG、release.py 执行 bump→changelog→build→commit→tag 全流程。当用户要求"更新/提升版本号"、"生成 CHANGELOG / 变更日志"、"发版 / 发布 / release"、"打 tag"、"准备发布"、"bump version"时使用。执行写操作前必须先 dry-run 预览并展示给用户,禁止自动 push。

Release Ops

版本发布工具链,脚本位于仓库根目录 scripts/,纯标准库实现,用 uv run python 执行。

版本号事实来源

  • pyproject.toml 的 [project].version 是唯一事实来源
  • src/oce/__init__.py 的 __version__ 必须同步(bump 脚本自动处理,并做一致性校验)
  • 校验 PEP 440;major/minor/patch 递增时丢弃 pre-release 段

命令速查

需求命令
版本号 +0.0.1uv run python scripts/bump_version.py patch
版本号 +0.1.0uv run python scripts/bump_version.py minor
指定具体版本uv run python scripts/bump_version.py 0.2.0
只预览不落盘上述命令加 --dry-run
bump 附带 git commit加 --commit(message: chore(release): vX.Y.Z)
预览 CHANGELOG(stdout)uv run python scripts/generate_changelog.py
生成指定版本段预览uv run python scripts/generate_changelog.py --version 0.2.0
写入 CHANGELOG.md 顶部加 --prepend
指定区间(tag 起)--since <ref> --to <ref>(默认最近 tag..HEAD,无 tag 取全量)
完整发布`uv run python scripts/release.py <major
发布前演练uv run python scripts/release.py minor --dry-run

标准发布流程(AI 执行步骤)

  1. 确认目标版本:读 pyproject.toml 当前版本;若用户只说"升个版本",按语义选 patch(修 bug)/ minor(新功能)/ major(破坏性)。
  2. 检查工作区:git status --porcelain 必须为空(release.py 会自动拦截,并会因未跟踪文件中止)。
  3. 演练:uv run python scripts/release.py <目标> --dry-run,把计划展示给用户确认。
  4. 执行(确认后):uv run python scripts/release.py <目标>。
    • 自动完成:bump 双文件同步 → CHANGELOG 新段(## [X.Y.Z] - 日期)写入 → uv build → commit chore(release): vX.Y.Z → annotated tag vX.Y.Z。
  5. 验证:git log -1 --oneline、git tag -l、git status --porcelain 干净。
  6. 收尾提示:push 与 uv publish 保持手动,脚本不自动执行,提醒用户即可。

约束(必须遵守)

  • 写操作前必须 dry-run:任何 bump / prepend / release 执行前先用 --dry-run 或 stdout 模式展示结果。
  • release.py 不自动 push:只做本地 commit + tag;push / PyPI 上传由用户手动。
  • CHANGELOG 过滤规则:chore / ci / test / revert 类提交不进 CHANGELOG;Breaking 变更(! 或 BREAKING CHANGE: footer)归入 ### Breaking Changes。
  • bump 的 --commit 与 release 二选一:release 内部统一 commit,不要叠加使用。
  • CHANGELOG 文件不存在时:--prepend 会自动创建(含文件头)。用户要求"生成初始 CHANGELOG"时可执行 uv run python scripts/generate_changelog.py --prepend(生成 Unreleased 段)。
  • 日期统一 UTC:版本段日期用 datetime.now(timezone.utc) 的 ISO 日期。

© oce-ai, Apache-2.0. 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 .claude/skills/release-ops of oce-ai/oce.

Open the folder on GitHubat commit d1f5493

Compare with similar skills

Release Ops 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.

Release Ops compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Release Ops this skilloce-ai/oce121—~627Automated safety check: PassApache-2.0
Commitizencommitizen-tools/commitizen3.5k—~839Automated safety check: PassMIT
pybind11 Release Preparationpybind/pybind1118k—~1.7kAutomated safety check: PassCustom licence
pybind11 Release Publicationpybind/pybind1118k—~2.5kAutomated safety check: PassCustom licence
Draft ReleaseDASDAE/dascore168—~1.1kAutomated safety check: PassCustom licence
WebRTC Changelog Generatorwebrtc-sdk/webrtc4461 repos~485Automated safety check: PassBSD-3-Clause

Similar skills

  • Commitizen

    commitizen-tools/commitizen

    A skill your agent uses for tasks involving Conventional Commits, commit message validation, Commitizen configuration, semantic version bumps, changelog generation, or CI/release automation with the…

    3.5k GitHub stars~839 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Opens the pybind11 release-preparation pull request: picking the release base, bumping the version in common.h and integrating the changelog, following docs/release.rst.

    18k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed
  • Walks a maintainer through publishing a pybind11 release after the preparation PR merges, with preflight checks, confirmations before each push and a GitHub release.

    18k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Draft Release

    DASDAE/dascore

    Draft the next release version and changelog by fetching tags, computing the next semantic v tag, collecting merged PRs into master since last release via gh, and printing the proposed version and…

    168 GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Builds a categorized HTML changelog for a WebRTC release from the git log between two branch heads, with a summary and commit and review links.

    446 GitHub starsUsed in 1 repo~485 tokens
    DevelopmentAuto-check passed
  • Release

    JustLookAtNow/pt_mate

    自动化项目的版本发布流程,包括版本号自增、ChangeLog 提取与汇总、代码提交、打标签以及推送到远程仓库. An agent skill from JustLookAtNow/pt_mate.

    503 GitHub stars~332 tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from oce-ai/oce

  • 为 OCE 检索评测构建或扩展基准集——也就是 bench/datasets/.jsonl 里的「问题 + 标准答案(expectedfiles)」。当被要求「出评测题/加题/扩充 benchmark/把题量提到 N 道/增加刁钻角度/为新仓库做基准/校准难度/复核 expectedfiles」时使用。涵盖题目 schema、评分语义、10…

    121 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Release Ops

What does Release Ops do?

OpenContextEngine (oce) 仓库的版本发布运营技能。使用 scripts/ 下的 bumpversion.py 更新版本号(pyproject.toml 与 src/oce/init.py 同步)、generatechangelog.py 从 git 提交生成 CHANGELOG、release.py 执行 bump→changelog→build→commit→tag…. Release Ops is an agent skill from oce-ai/oce.

When should I use Release Ops?

Release Ops fits situations like: tasks that involve Changelog and release notes.

How do I install Release Ops in Claude Code?

Run `npx skills add oce-ai/oce --skill release-ops -a claude-code`. Or copy the skill folder (.claude/skills/release-ops in oce-ai/oce) into .claude/skills/release-ops in your project. Claude Code loads it when a task matches its description.

How do I install Release Ops in Codex?

Run `npx skills add oce-ai/oce --skill release-ops -a codex`. Or copy the skill folder (.claude/skills/release-ops in oce-ai/oce) into .agents/skills/release-ops in your project. Codex loads it when a task matches its description.

Can I use Release Ops 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 oce-ai/oce --skill release-ops -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-ops, .gemini/skills/release-ops, .github/skills/release-ops and .opencode/skills/release-ops in your project.

What does Release Ops need to run?

Going by SKILL.md and its folder, Release Ops needs the command-line tools its instructions call (uv and git). Our summary lists: Python 3.

Does Release Ops access the network?

SKILL.md contains no URLs. Its commands use uv and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Release Ops 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 Ops use?

Release Ops is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Release Ops use?

About 627 tokens (SKILL.md is roughly 2.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 Ops?

Skills that share tags, products or a category with Release Ops: Commitizen (commitizen-tools/commitizen, 3.5k stars), pybind11 Release Preparation (pybind/pybind11, 18k stars), pybind11 Release Publication (pybind/pybind11, 18k stars) and Draft Release (DASDAE/dascore, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release Ops?

oce-ai (a GitHub organization) maintains it in oce-ai/oce, which has 121 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 8, 2026.

Source: oce-ai/oce on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.