release
Cut an Atmosphere release end to end — the only path to release-4x.yml. Use whenever a release, a version cut, "ship it" or publishing to Maven Central/npm/Homebrew/SDKMAN is requested. Runs the preflight in order (open carnet, compatibility review, CI green on HEAD, sample sweep covering HEAD), triggers the workflow, verifies every distribution channel, labels the carnet, and cleans up. Stops at the first failed check.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 3.8k
- Forks
- 765
01 前言 Front Matter
- name
- release
- description
- Cut an Atmosphere release end to end — the only path to release-4x.yml. Use whenever a release, a version cut, "ship it" or publishing to Maven Central/npm/Homebrew/SDKMAN is requested. Runs the preflight in order (open carnet, compatibility review, CI green on HEAD, sample sweep covering HEAD), triggers the workflow, verifies every distribution channel, labels the carnet, and cleans up. Stops at the first failed check.
03 SKILL.md 正文
Release
release-4x.yml publishes to five channels that cannot be taken back:
- Maven Central and npm are immutable.
- Homebrew and SDKMAN are announced to users.
This skill is the checklist in front of it. Run every step in order and stop at the first one that fails. A failed check is reported to the maintainer with the evidence. It is never worked around, and never answered with "CI is green, so it is probably fine": that reasoning shipped 4.0.75 without a sweep of its last three user-facing changes.
Step 1: Open carnet
gh issue list -R "$(.agents/skills/carnet/carnet.sh tracker)" --state open \
--json number,title -q '.[] | "#\(.number) \(.title)"'
.agents/skills/carnet/carnet.sh status --short
Every open entry is either fixed or explicitly excluded by the maintainer for this release. An exclusion from a previous release does not carry over: ask again. An entry another session holds in progress blocks the release.
Step 2: Compatibility review
PREV=$(git tag --list 'atmosphere-4.*' --sort=-v:refname | head -1)
git log --oneline "$PREV..origin/main" -- ':(glob)modules/**/src/main/**' atmosphere.js/src
List every change to a public API, wire format, default, configuration key or dependency version. Name each one to the maintainer and get a yes before continuing. Silence is not a yes.
Step 3: CI green on the exact commit
git fetch origin && SHA=$(git rev-parse origin/main)
gh run list --commit "$SHA" -L 100 --json name,status,conclusion \
-q '.[] | "\(.status)\t\(.conclusion)\t\(.name)"'
- Pass the full SHA:
--commitwith a short SHA silently matches nothing. - Every workflow must be
completed+success. A failure is fixed and the check starts again from Step 1, because the fix is a new commit.
Step 4: The sample sweep covers the commit
git checkout --detach origin/main && ./scripts/validate-sweep-attestation.sh
This is the same gate release-4x.yml runs first.
- If it fails, run the
release-sample-sweepskill: the full sweep, or its Step 4 re-test for the surfaces the gate lists. - Commit the new
.harness/sweep-attestation.json, then start again from Step 3. - "The changes have Playwright specs" is not coverage. The sweep drives packaged artifacts in a browser and the simulator, and specs do not.
skip_sweep_gateis for an emergency the maintainer declares in words. It is never the agent's call.
Step 5: Trigger
gh workflow run release-4x.yml --ref main \
-f release_version=X.Y.Z -f next_dev_version=X.Y.(Z+1)-SNAPSHOT \
-f publish_js=true -f js_only=false -f dry_run=false
Watch the run until it completes. A failed job is diagnosed from its log before anything else is triggered:
gh run rerun <id> --failedretries only the jobs that failed;- a full re-run would collide with the tag and the versions that were already published.
Step 6: Verify every channel from outside the workflow
| Channel | Check |
|---|---|
| Maven Central | curl -s -o /dev/null -w '%{http_code}' https://repo1.maven.org/maven2/org/atmosphere/atmosphere-runtime/X.Y.Z/atmosphere-runtime-X.Y.Z.pom returns 200 (also check atmosphere-ai) |
| npm | npm view atmosphere.js version and the latest dist-tag |
| GitHub release | gh release view atmosphere-X.Y.Z shows not draft, with the zip and .sha256 |
| Homebrew | the tap formula Formula/atmosphere.rb is at X.Y.Z |
| SDKMAN | the Publish CLI to SDKMAN job is green, and https://api.sdkman.io/2/broker/download/atmosphere/X.Y.Z/darwinarm64 returns 302 (the default and list endpoints lag behind) |
| main | the pom is X.Y.(Z+1)-SNAPSHOT and atmosphere.js is bumped |
Then wait for CI on the bump commit. The chore(js) bump is pushed by the
bot and triggers no workflows, so watch the prepare for next development iteration commit before it.
Step 7: Close out
carnet.sh label <n> +X.Y.Zfor every carnet entry the release fixed.- Remove the release worktrees and branches. A worktree that has submodules
needs
--force; check first that it is clean and has no unpushed commits. - Report to the maintainer: one row per channel with its evidence, anything that failed, and anything still open.
04 同仓库更多 Skills
support-agent
暂无简介
billing-agent
暂无简介
omnichannel-chat
General-purpose AI assistant that answers naturally over web chat and external messaging platforms (Telegram, Slack, Discord, WhatsApp, Messenger). One agent, every channel.
writer-agent
Business writer that synthesizes research, strategy, and financial findings into executive briefings and reports. Use after upstream specialist agents have produced their data.
tool-assistant
Tool-calling assistant with backend functions for time, city time, weather, and temperature conversion, plus cost metering and approval workflows. Use when a question needs real-time data via tool calls.
support-agent
Front-line support desk for account questions, technical troubleshooting, and general inquiries. Use as the default customer entry point; routes billing questions to the billing-agent via handoff.