ShareX.ImageEditor Release Bump Tag
Overview
Use this skill to run release steps in strict order:
- Step 1: Execute maintenance chores first (
git pull --recurse-submodules and git submodule update --init --recursive)
- Step 2: Run
.ai/skills/update-changelog/SKILL.md second (optional if no CHANGELOG.md exists)
- Step 3: Verify build, then execute bump/commit/push/tag automation
- Step 4: Monitor the tag-triggered release workflow every 2 minutes
- Step 5: If failure occurs, inspect logs, fix issues, and retry with the next patch version
- Step 6: Ensure standard release notes block is present on the GitHub release
- Step 7: Set the successful release as pre-release by default (opt out only when intentionally publishing stable)
Step 3 performs:
- Pre-check: Run
dotnet build ShareX.ImageEditor.sln; do not proceed if build fails.
- Prompts for
x/y/z bump type (major/minor/patch) unless specified.
- Updates every tracked
Directory.Build.props file that defines <Version>.
- Stages all current repo changes.
- Commits with version-prefixed message.
- Pushes current branch and creates/pushes annotated tag
vX.Y.Z.
Step 4-5 performs:
- Find tag run for
Release Build.
- Poll run status every 120 seconds until completion.
- On failure, inspect failing job logs and identify first blocking error.
- Fix root cause in code/workflow/scripts.
- Re-run local pre-check build.
- Retry release using next patch bump, then monitor again.
- Repeat until workflow succeeds.
Step 6 performs:
- Ensures release notes always include a link to the releases page.
- After the release is published, attach any build artifacts if the workflow produces them.
Primary Command
From repository root:
./.ai/skills/publish-release/scripts/run-release-sequence.sh
Automated monitor + default pre-release (recommended):
./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --monitor --set-prerelease --bump z --yes
Stable release opt-out example:
./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --monitor --no-prerelease --bump z --yes
Non-Interactive Examples
Patch bump, no prompts:
./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --bump z --yes
Patch bump with built-in 2-minute monitoring:
./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --monitor --monitor-interval 120 --bump z --yes
Minor bump with custom commit token/summary:
./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --bump y --type CI --summary "Prepare release artifacts" --yes
Preview only:
./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --bump z --dry-run --yes
When bash is unavailable (e.g. Windows PowerShell)
On environments where bash is not in PATH, execute the sequence manually:
Step 1 - Maintenance
git pull --recurse-submodules
git submodule update --init --recursive
Step 2 - Changelog
- Run
.ai/skills/update-changelog/SKILL.md.
- Skip if no
CHANGELOG.md or user confirms skip.
Step 3 - Bump, commit, push, tag
- Run
dotnet build ShareX.ImageEditor.sln; abort if it fails.
- Read current version from root
Directory.Build.props.
- Compute next version: patch
Z+1, minor Y+1.0, major X+1.0.0.
- Ensure tag
v<new-version> does not exist locally or on origin.
- Update all tracked
Directory.Build.props files containing <Version>.
git add -A -> git commit -m "[v<new-version>] [CI] Release v<new-version>" -> git push origin <current-branch> -> git tag -a v<new-version> -m "v<new-version>" -> git push origin v<new-version>.
Step 4 - Monitor every 2 minutes
- Find run:
gh run list --limit 10 --json databaseId,workflowName,headBranch,status,conclusion,url
- Poll:
sleep 120; then gh run view <run-id> --json status,conclusion,jobs,url
Step 5 - On failure, fix and retry
- Fetch failed job logs:
gh run view <run-id> --job <job-id> --log
- Fix root cause in repository.
- Re-run
dotnet build ShareX.ImageEditor.sln.
- Repeat Step 3 with next patch version.
Step 6 - Ensure standard release notes content
- Read current body:
gh release view v<new-version> --json body
- Append the standard releases link if missing.
- Write body:
gh release edit v<new-version> --notes-file <file>
Step 7 - Set pre-release (default behavior)
gh release edit v<new-version> --prerelease
- Verify:
gh release view v<new-version> --json isPrerelease,url,assets
- Stable opt-out: skip this step only when intentionally publishing stable.
Default bump when unspecified: patch (z). Default commit type token: CI.
Behavior
- Require completion of
run-maintenance first.
- Script behavior: executes maintenance commands automatically unless explicitly bypassed with
--skip-maintenance (or legacy alias --assume-maintenance-done).
- Require completion of
update-changelog second (skip if no CHANGELOG.md or user confirms).
- Before bump, run
dotnet build ShareX.ImageEditor.sln; abort on failure.
- Run
scripts/bump-version-commit-tag.sh (or PowerShell/manual equivalent when bash unavailable).
- After tag push, monitor the release workflow every 120 seconds until complete.
- If failed, inspect logs, fix root cause, and retry with next patch version.
- Continue retry loop until release workflow is successful.
- Ensure standard release notes content is present on the successful release.
- Mark successful release as pre-release by default; only skip when explicitly publishing stable.
Guardrails
- Do not skip sequence unless user explicitly requests bypass.
- Do not skip maintenance unless user explicitly requests bypass (
--skip-maintenance).
- Do not commit/push during maintenance/changelog steps.
- Always verify build before bump/tag.
- Always monitor workflow after tag push; do not stop at tag creation.
- Always inspect logs on failure and fix root cause before retry.
- Always ensure the standard release notes block exists on the successful release.
- Always use a new patch version for retries requiring new commits/tags.
- Abort on detached HEAD.
- Abort if version format is not
X.Y.Z.
- Abort if matching tag already exists locally or remotely.
- Support
--no-push and --no-tag when partial flow is needed.
Agent usage (Cursor / Codex)
When executing this skill:
- Run sequence: maintenance -> changelog -> build verify -> bump/commit/push/tag.
- Use bash scripts if bash exists; otherwise use PowerShell/manual flow.
- Default bump is patch (
z) when unspecified.
- Monitor tag workflow every 120 seconds until completion.
- On failure, inspect logs, fix issue, and retry with next patch version.
- Ensure release notes include the releases page link.
- If requested, set the final successful release to pre-release.
- Report final version, commit hash, branch push status, tag push status, run URL, and pre-release status.
Default pre-release policy: unless explicitly instructed otherwise, keep --set-prerelease enabled. Use --no-prerelease only for intentional stable publishes.
Notes (lessons learnt)
- Build before bump: avoid tagging broken trees.
- Changelog optional: do not block if
CHANGELOG.md does not exist unless user requires it.
- Version sync: update every tracked
Directory.Build.props with <Version>.
- Release reliability loop: tag push is not the end; monitor, fix, and retry until green.
- Workflow name: the GitHub Actions workflow is
Release Build — update this in run-release-sequence.sh if the workflow file name changes.
1---2name: publish-release-23description: "Orchestrate ShareX.ImageEditor release flow in strict order: run-maintenance first, update-changelog second (optional if no CHANGELOG), verify build, bump/commit/push/tag, monitor GitHub Actions every 2 minutes, ensure standard release notes, then set pre-release by default (use explicit opt-out for stable). On failures, inspect logs, fix root cause, and retry with the next patch release."4---56# ShareX.ImageEditor Release Bump Tag78## Overview910Use this skill to run release steps in strict order:11- Step 1: Execute maintenance chores first (`git pull --recurse-submodules` and `git submodule update --init --recursive`)12- Step 2: Run `.ai/skills/update-changelog/SKILL.md` second (optional if no `CHANGELOG.md` exists)13- Step 3: Verify build, then execute bump/commit/push/tag automation14- Step 4: Monitor the tag-triggered release workflow every 2 minutes15- Step 5: If failure occurs, inspect logs, fix issues, and retry with the next patch version16- Step 6: Ensure standard release notes block is present on the GitHub release17- Step 7: Set the successful release as pre-release by default (opt out only when intentionally publishing stable)1819Step 3 performs:20- Pre-check: Run `dotnet build ShareX.ImageEditor.sln`; do not proceed if build fails.21- Prompts for `x/y/z` bump type (major/minor/patch) unless specified.22- Updates every tracked `Directory.Build.props` file that defines `<Version>`.23- Stages all current repo changes.24- Commits with version-prefixed message.25- Pushes current branch and creates/pushes annotated tag `vX.Y.Z`.2627Step 4-5 performs:28- Find tag run for `Release Build`.29- Poll run status every 120 seconds until completion.30- On failure, inspect failing job logs and identify first blocking error.31- Fix root cause in code/workflow/scripts.32- Re-run local pre-check build.33- Retry release using next patch bump, then monitor again.34- Repeat until workflow succeeds.3536Step 6 performs:37- Ensures release notes always include a link to the releases page.38- After the release is published, attach any build artifacts if the workflow produces them.3940## Primary Command4142From repository root:4344```bash45./.ai/skills/publish-release/scripts/run-release-sequence.sh46```4748Automated monitor + default pre-release (recommended):4950```bash51./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --monitor --set-prerelease --bump z --yes52```5354Stable release opt-out example:5556```bash57./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --monitor --no-prerelease --bump z --yes58```5960## Non-Interactive Examples6162Patch bump, no prompts:6364```bash65./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --bump z --yes66```6768Patch bump with built-in 2-minute monitoring:6970```bash71./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --monitor --monitor-interval 120 --bump z --yes72```7374Minor bump with custom commit token/summary:7576```bash77./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --bump y --type CI --summary "Prepare release artifacts" --yes78```7980Preview only:8182```bash83./.ai/skills/publish-release/scripts/run-release-sequence.sh --assume-changelog-done --bump z --dry-run --yes84```8586## When bash is unavailable (e.g. Windows PowerShell)8788On environments where `bash` is not in PATH, execute the sequence manually:89901. Step 1 - Maintenance91 - `git pull --recurse-submodules`92 - `git submodule update --init --recursive`93942. Step 2 - Changelog95 - Run `.ai/skills/update-changelog/SKILL.md`.96 - Skip if no `CHANGELOG.md` or user confirms skip.97983. Step 3 - Bump, commit, push, tag99 - Run `dotnet build ShareX.ImageEditor.sln`; abort if it fails.100 - Read current version from root `Directory.Build.props`.101 - Compute next version: patch `Z+1`, minor `Y+1.0`, major `X+1.0.0`.102 - Ensure tag `v<new-version>` does not exist locally or on `origin`.103 - Update all tracked `Directory.Build.props` files containing `<Version>`.104 - `git add -A` -> `git commit -m "[v<new-version>] [CI] Release v<new-version>"` -> `git push origin <current-branch>` -> `git tag -a v<new-version> -m "v<new-version>"` -> `git push origin v<new-version>`.1051064. Step 4 - Monitor every 2 minutes107 - Find run: `gh run list --limit 10 --json databaseId,workflowName,headBranch,status,conclusion,url`108 - Poll: `sleep 120`; then `gh run view <run-id> --json status,conclusion,jobs,url`1091105. Step 5 - On failure, fix and retry111 - Fetch failed job logs: `gh run view <run-id> --job <job-id> --log`112 - Fix root cause in repository.113 - Re-run `dotnet build ShareX.ImageEditor.sln`.114 - Repeat Step 3 with next patch version.1151166. Step 6 - Ensure standard release notes content117 - Read current body: `gh release view v<new-version> --json body`118 - Append the standard releases link if missing.119 - Write body: `gh release edit v<new-version> --notes-file <file>`1201217. Step 7 - Set pre-release (default behavior)122 - `gh release edit v<new-version> --prerelease`123 - Verify: `gh release view v<new-version> --json isPrerelease,url,assets`124 - Stable opt-out: skip this step only when intentionally publishing stable.125126Default bump when unspecified: patch (`z`). Default commit type token: `CI`.127128## Behavior1291301. Require completion of `run-maintenance` first.131 - Script behavior: executes maintenance commands automatically unless explicitly bypassed with `--skip-maintenance` (or legacy alias `--assume-maintenance-done`).1322. Require completion of `update-changelog` second (skip if no `CHANGELOG.md` or user confirms).1333. Before bump, run `dotnet build ShareX.ImageEditor.sln`; abort on failure.1344. Run `scripts/bump-version-commit-tag.sh` (or PowerShell/manual equivalent when bash unavailable).1355. After tag push, monitor the release workflow every 120 seconds until complete.1366. If failed, inspect logs, fix root cause, and retry with next patch version.1377. Continue retry loop until release workflow is successful.1388. Ensure standard release notes content is present on the successful release.1399. Mark successful release as pre-release by default; only skip when explicitly publishing stable.140141## Guardrails142143- Do not skip sequence unless user explicitly requests bypass.144- Do not skip maintenance unless user explicitly requests bypass (`--skip-maintenance`).145- Do not commit/push during maintenance/changelog steps.146- Always verify build before bump/tag.147- Always monitor workflow after tag push; do not stop at tag creation.148- Always inspect logs on failure and fix root cause before retry.149- Always ensure the standard release notes block exists on the successful release.150- Always use a new patch version for retries requiring new commits/tags.151- Abort on detached HEAD.152- Abort if version format is not `X.Y.Z`.153- Abort if matching tag already exists locally or remotely.154- Support `--no-push` and `--no-tag` when partial flow is needed.155156## Agent usage (Cursor / Codex)157158When executing this skill:1591. Run sequence: maintenance -> changelog -> build verify -> bump/commit/push/tag.1602. Use bash scripts if bash exists; otherwise use PowerShell/manual flow.1613. Default bump is patch (`z`) when unspecified.1624. Monitor tag workflow every 120 seconds until completion.1635. On failure, inspect logs, fix issue, and retry with next patch version.1646. Ensure release notes include the releases page link.1657. If requested, set the final successful release to pre-release.1668. Report final version, commit hash, branch push status, tag push status, run URL, and pre-release status.167168Default pre-release policy: unless explicitly instructed otherwise, keep `--set-prerelease` enabled. Use `--no-prerelease` only for intentional stable publishes.169170## Notes (lessons learnt)171172- Build before bump: avoid tagging broken trees.173- Changelog optional: do not block if `CHANGELOG.md` does not exist unless user requires it.174- Version sync: update every tracked `Directory.Build.props` with `<Version>`.175- Release reliability loop: tag push is not the end; monitor, fix, and retry until green.176- **Workflow name**: the GitHub Actions workflow is `Release Build` — update this in `run-release-sequence.sh` if the workflow file name changes.