Cut a stable (or dev) release of the heygen CLI end to end: run RELEASE.md's pre-release checklist, land pending PRs, check the command surface, run E2E, pick the version, write the changelog, trigger the release workflow, publish the notes, and verify the installer. Stops for the user at every decision. Use when asked to "cut a release", "ship a new version", or "release the CLI". Takes "stable" (the default) or "dev" as an optional argument.
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
RELEASE.md is the source of truth for every step below; this skill runs it in order and adds where to stop and what tends to go wrong. When the two disagree, RELEASE.md wins, and fix this file.
Work from a fresh fetch, never from the local main checkout, which may be
behind. Set LAST_STABLE and RELEASE_COMMIT exactly as RELEASE.md's pre-release
checklist shows and keep them for the whole run: RELEASE_COMMIT is what every
step checks and what stop 4 releases. If a merge at step 2 moves origin/main,
fetch, set RELEASE_COMMIT again, and redo from step 1.
Stop and ask the user before each of these, with what you found and a
recommendation. Never proceed on a guess. Each stop needs an explicit yes for
that specific action, in this session: the original request, a yes at an earlier
stop, or silence does not count. The one exception is stop 4, whose yes also
covers publishing its notes. If the action changes after the yes (a new head
after a rebase, a different commit on main, edited notes), ask again.
main), approving it, or merging it.HEYGEN_API_KEY. Ask
which key to use; do not go looking for one.RELEASE_COMMIT,
and the notes file step 9 will publish (a dev release has none), and record
its shasum -a 256. Dispatch with -f commit=<that SHA> so the workflow
releases exactly that commit. A yes here also covers publishing that file at
step 9 for this version.shasum -a 256 on the file then matches the hash recorded at the most recent
stop 4 yes in this session for this version: show the final notes. A lost
hash means asking.Reading, checking, building, and local edits need no approval. Anything else
visible outside this machine is a stop too, even if it is not listed above:
pushing any branch or tag, opening, closing, commenting on or labelling PRs or issues,
re-running or cancelling workflow runs, and changing variables, secrets, caches
or repository settings. Never bypass branch protection: no --admin, no direct
push to main.
Follow RELEASE.md step 1. Flag anything that looks half-finished, and any PR that says it must not ship before something else is deployed: read the bodies of the merged PRs in the range for that.
Follow RELEASE.md step 2, then sort what you find:
codegen: resync gen/ from EF <sha>, opened by the
sync bot) usually belongs in the release. If its CI fails on
TestAllGeneratedCommandsHaveExamples, the fix is examples for the new
commands in codegen/examples/<group>.yaml, regenerated with
make generate SPEC=<spec> STRICT=1. Use the spec from the EF commit the PR
body names; first confirm that regenerating from it reproduces the bot's
gen/ byte for byte, then add the examples, so gen/ changes only by them.main requires branches to be up to date, so merging
one PR puts the next one behind. Rebase it, confirm its diff is unchanged,
push, and get an approval on the new head. Never merge with --admin.gh pr merge <n> --squash --match-head-commit <sha>, pinned to the
commit that was reviewed and green.Follow RELEASE.md step 3, after any merges from step 2.
Follow RELEASE.md step 4 and its Checking for Regressions
section, against RELEASE_COMMIT. Read every < line with the
table there. The deprecated check matches loosely: a hit whose help text only
mentions a deprecated value (for example an enum alias) is a false positive;
say so rather than putting it in the notes.
With the user's key, run the e2e-cli-test skill. All phases must pass; a
Phase 3 WARN means the account lacks data, so check that the skipped commands'
lists really are empty before calling it fine.
Apply RELEASE.md step 6's rules. New command groups or significant new capability mean a minor bump; anything breaking from step 4 is at least a minor.
Run the changelog-cli skill with the version. Then check every flag and command
it names against gen/: a flag that already existed in LAST_STABLE is not new.
Put step 4's breaking or deprecated findings at the top, as RELEASE.md says.
Save the notes to a file; you will publish them after the release.
Follow RELEASE.md's "Trigger the release", passing -f commit=<SHA> with the
commit the user approved at stop 4, and wait for the run to finish. Then fetch the
tag (git fetch origin tag <version>) and confirm git rev-parse <version>^{commit}
is that commit; if not, stop and tell the user before step 9. A re-dispatch under
stop 6 passes the same commit. If any
job fails, read If the release fails
to find the prescribed recovery, then stop (stop point 6) before acting on it.
Do not delete tags or releases by hand unless that section says to.
Follow RELEASE.md's "Post-release": confirm the release is published, replace its
body with the notes file from stop 4 (gh release edit <version> --notes-file <file>; stop point 5 unless its hash still matches) and read it back, and verify
the installer into a scratch directory rather than over the user's own heygen.
install.sh reads INSTALL_DIR, so it goes on bash, not curl: d=$(mktemp -d); curl -fsSL https://static.heygen.ai/cli/install.sh | INSTALL_DIR="$d" bash,
then run "$d/heygen" --version.
Follow RELEASE.md's "How to Cut a Dev Release". There is no checklist, but
triggering it is stop point 4: confirm the user wants one, show the commit, and
dispatch with -f commit=<SHA> as for a stable release. If it fails, "If the release fails"
applies, except that dev releases have no publish-cdn job. Give the release
link to the user; sharing it with anyone else is theirs to do.
End with: the version and tag commit, the release link, what merged first, the surface findings, the E2E result, and anything left open.
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Generate a user-facing changelog for the next stable release. Reads git log between the last stable tag and HEAD, categorizes changes, and outputs formatted release notes. Use before triggering a stable release. Takes the version as an optional argument (for example v0.0.6).
日本語の概要は準備中です。原文の説明を表示しています。
End-to-end test of the heygen CLI against the live API. Builds the binary, then exercises auth, list, get, --human, schema, error handling, and the full create-poll-download-delete write path. Spends a small number of API credits per run. Use before cutting a stable release.
日本語の概要は準備中です。原文の説明を表示しています。
Create AI videos, manage avatars, translate videos, and download results via the HeyGen API. Use when an agent needs to generate videos from text prompts, create avatar-based videos, translate existing videos, or automate video production workflows.
日本語の概要は準備中です。原文の説明を表示しています。