Version Update Skill
<scripts>Cross-stack semantic version update for node/rust/python.
Available scripts
| Script | Purpose |
|---|---|
scripts/stack-detect.sh | Detect stacks (node, rust, python) |
scripts/version-find.sh [--plain] | Discover version-bearing files |
scripts/version-current.sh [file] | Extract current semver (`file |
scripts/version-bump.sh <current> <type> | Calculate next semver |
scripts/version-apply.sh <new> [files...] | Apply version to discovered/selected files |
scripts/git-commit.sh "msg" [files] | Commit changed files |
scripts/git-push.sh | Push current branch safely |
<version_rules>
| Argument | Action | Example |
|---|---|---|
+1 / +patch | Patch +1 | 0.1.13 -> 0.1.14 |
+minor | Minor +1 | 0.1.13 -> 0.2.0 |
+major | Major +1 | 0.1.13 -> 1.0.0 |
x.y.z | Explicit set | 0.1.13 -> 2.0.0 |
</version_rules>
<workflow>Workflow
# 1) detect stack(s)
scripts/stack-detect.sh
# 2) find version-bearing files
scripts/version-find.sh
# 3) read current version
scripts/version-current.sh
# output: <file>|<version>
# 4) compute next version
scripts/version-bump.sh 1.2.3 +minor
# -> 1.3.0
# 5) apply to all discovered files (or selected files)
scripts/version-apply.sh 1.3.0
# 6) commit
scripts/git-commit.sh "chore: bump version to 1.3.0"
# 7) optional push
scripts/git-push.sh
<stack_targets>
| Stack | Primary files | Additional patterns |
|---|---|---|
| Node | package.json | .version('x.y.z') in code |
| Rust | Cargo.toml ([package].version) | .version('x.y.z') in code |
| Python | pyproject.toml, setup.py, __version__ in .py | .version('x.y.z') in code |
</stack_targets>
<required>| Category | Required |
|---|---|
| Input | Parse ARGUMENT as bump rule or explicit semver |
| Discovery | Run version-find.sh before applying updates |
| Consistency | Keep all discovered version files synchronized |
| Safety | Use conventional commit message (chore: bump version to x.y.z) |
| Git | Keep git write operations sequential |
Execution checklist:
- Current version identified with
version-current.sh - Target version computed via
version-bump.sh(or explicit semver validated) -
version-apply.shupdated all intended files -
git diffreviewed - Commit created with
scripts/git-commit.sh - Optional push executed only when requested
Forbidden:
- Starting updates without reading current version
- Updating only one file when multiple version files exist
- Force-pushing protected branches