release
Skill5 starsChanged 12 days agoMITView on GitHub
tanacode の新しいバージョン(vX.Y.Z)をリリースする手順。引数は新しいバージョン(例 0.1.4)。省くと、変更点から patch・minor・major のどれを上げるかを提案します。バージョンを上げる PR・タグのプッシュ・GitHub Actions の見守り・下書きの点検・公開まで。新しいバージョンを出すときに使います。
- Commits and pushes
193 other projects use a version of this.
Adopted by
Most recently taken up by
- yicheng47/runnertheir own version, first seen Nov 13, 2026
- eugene1g/agent-safehousetheir own version, first seen Nov 12, 2026
- BlockRunAI/ClawRoutertheir own version, first seen Nov 11, 2026
- cubeplexai/cubeplextheir own version, first seen Nov 10, 2026
- bex-co/bextheir own version, first seen Nov 10, 2026
- Yeachan-Heo/oh-my-claudecodetheir own version, first seen Nov 9, 2026
Used with
Projects with it also use create-agent-adapter, changelog-style and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
MicrosoftSkillcreate-agent-adapter
Technical guide for creating a new Paperclip agent adapter. Use when building a new adapter package, adding support for a new AI coding tool (e.g. a new CLI agent, API-based agent, or custom process), or when modifying the adapter system. Covers the required interfaces, module structure, registration points, and conventions derived from the existing claude-local and codex-local adapters.
Also in 5 projects that use this
GrinvSkillchangelog-style
Turn a commit range into CHANGELOG.md entries following common-changelog style. Use when finishing a PR or cutting a release, to write/fix the [Unreleased] section's entries — moving [Unreleased] under a new dated version heading is a separate, automated step (see the release skill / scripts/sync-version.ts), not this skill's job.
Also in 4 projects that use this
GrinvSkilldocs-consistency-check
Check README/manifest.json/server.json/CHANGELOG.md/AGENTS.md and docs/*.md for drift against the actual registered tools and source. Use after adding, renaming, or removing a tool, or as part of a live-audit pass.
Also in 4 projects that use this
Microsoft AzureSkillcomponent-release
Prepares a verifiable Agent Landing Zone UI release. Use for release branches, VERSION, changelog entries, tags, release notes, and compatibility evidence; never publish without explicit human approval.
Also in 4 projects that use this
Microsoft AzureSkilldocumentation-consistency
Keeps AI Landing Zone contributor, user, and operator documentation aligned with shipped Bicep behavior. Use for parameters, defaults, outputs, topology, deployment flow, operations, or releases.
Also in 8 projects that use this
rivet-devSkilllaunch-graphics
Generate agentOS marketing/launch graphics (launch & social heroes, code-snippet cards) from the committed generators in docs-internal/graphics. Use when asked to make, update, or render an agentOS launch image, social image, "agentOS Apps" graphic, or technical code-snippet image.
Also in 3 projects that use this
- +3 more from Grinv
Other versions193 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 193
- paperclipai/paperclip★ 114ksame name
- modelcontextprotocol/servers★ 92ksame name
- remotion-dev/remotion★ 73ksame name
- traefik/traefik★ 66ksame name
- usememos/memos★ 64ksame name
- tw93/Pake★ 64ksame name
- amruthpillai/reactive-resume★ 46ksame name
- reactive-resume/reactive-resume★ 46ksame name
- AmruthPillai/Reactive-Resume★ 45ksame name
- Yeachan-Heo/oh-my-claudecode★ 41ksame name
183 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- AGENTS.mdAGENTS.md
- claude-code-eventsSkill
- securitySkill
- update-appSkill
The file
Files
リリースの手順
新しいバージョンをリリースするための手順書。タグ vX.Y.Z をプッシュすると、.github/workflows/release.yml が Apple Silicon 用と Intel 用の zip と pkg を作り、SHA256SUMS.txt を付けて GitHub Releases の下書きに置きます。下書きの説明は、ダウンロードの表と、畳んだ PR の一覧(自動で作る What's Changed)・SHA-256 の表だけ。先頭の変更点(「変更点の書き方」の形)は、このスキルが足します。公開は下書きを点検してから。
以下の X.Y.Z は新しいバージョン(/release 0.1.4 の引数。省いたときは 1 の 3 で決めたもの)、<前のタグ> は直前のリリースのタグ(例: v0.1.2)に置き換えます。リポジトリは sny-tanaka/tanacode。
手元と cloud の違い
手順は同じで、GitHub を操作する道具だけが違います。始める前に gh auth status を実行し、通らなければ cloud として進めます。
| 場所 | GitHub の操作 | タグ付け・点検・公開 |
手元(gh が使える) | この手順の gh のコマンド | 手元でタグをプッシュし、gh で点検・公開 |
| Claude Code の cloud のセッション | MCP のツール(mcp__github__*)。gh は使えません | Actions を手動で起動して任せます(タグのプッシュは、セッションの中継が 403 で断るため) |
- cloud では、各節の「cloud では」の手順に置き換えます。
- cloud の Actions の起動は、どちらも develop で行います(
mcp__github__actions_run_triggerのrun_workflow、refはdevelop)。release.ymlにversion: ビルドが通ってからタグを付け、下書きを作るrelease-publish.ymlにversion・notes: 下書きを点検し、変更点を足して公開する
決まり
- オーナーの操作は、なしにします。確認を挟まず、バージョンを上げる PR のマージから公開まで進めます。
/releaseを呼んだこと自体が、リリースしてよいという指示です。 - develop には直接プッシュしません。作業用のブランチ → develop 向けの PR → squash マージ。
- develop のルールセットは、PR を通すことを求めます(承認の数は 0)。
- バージョンを上げる PR に限り、CI がすべて通っていれば、エージェントがマージします(オーナーの指示。2026-10-01)。ほかの PR は、これまでどおりオーナーがマージします。
- マージするのは、変更が
package.jsonとpackage-lock.jsonのversionだけの PR(2 の 1 で確かめた PR)に限ります。
- 手を止めてユーザーに聞くのは、次の場合だけです。選択を伴うので AskUserQuestion を使い、推奨の選択肢を先頭に置いて、ラベルの末尾に「(推奨)」。
- 引数でバージョンが渡されていないとき(1 の 3。提案を添えて聞きます)
- 点検(5)で、期待と違うものが見つかったとき(公開はしません)
- 失敗の原因が 4 の表の中になく、どうするか決められないとき
- タグの削除・下書きの削除など、取り消しにくい操作(7)
- Apple の署名・公証は無し(自己署名の証明書で署名します。証明書は環境 release の Secrets に置いてあり、無いとワークフローが止まります)。利用者には README の手順で開いてもらいます。
1. 準備
develop が最新でクリーンか確かめます。
git fetch origin --tags git switch develop git pull --ff-only git status --shortgit status --shortに何か出たら、そこで止めてユーザーに伝えます(勝手に退避・破棄はしません)。前のタグと、そこからの変更を見ます。
git describe --tags --abbrev=0 git log <前のタグ>..develop --oneline gh pr list --state merged --base develop --limit 50 --json number,title,mergedAtPR の一覧は、前のタグの日付より後にマージされたものだけを拾います。
cloud では、PR の一覧を
mcp__github__search_pull_requests(repo:sny-tanaka/tanacode is:merged base:develop merged:>=<前のタグの日付>)で拾います。本文まで取ると大きいので、fieldsでnumber・titleに絞り、要る PR だけ本文を読みます。新しいバージョン
X.Y.Zを決めます。- 引数で渡されていれば、それを使います(聞きません)。
- 渡されていないときは、2 の変更を 1 つずつ読んで上げ方を提案し、AskUserQuestion で確かめます(下の「バージョンの上げ方の決め方」)。
git ls-remote --tags origin vX.Y.Zで、同じタグがまだ無いことを確かめます。あれば止めてユーザーに伝えます。
バージョンの上げ方の決め方
PR のタイトルの頭(
feat:・fix:など)は目安にとどめ、本文と差分で、使う人から見て何が変わるかを確かめます。変更ごとに次の表で分け、いちばん大きいものを提案にします。上げ方 当てはまる変更 major( X+1.0.0)使う人が何かし直さないと、今までどおりに使えなくなる変更。保存した設定・セッションを引き継げない、機能やメニューを無くす、対応する macOS や Claude Code の下限を上げる、インストールや更新の手順が変わる、など minor( X.Y+1.0)それまで無かった機能の追加。今までの使い方はそのまま通るもの patch( X.Y.Z+1)今ある機能の改善(扱えるもの・使える場面を増やす、動きや画面を良くする)、不具合の修正、見た目の小さな直し、動作確認済の Claude Code の更新、性能の改善。使い方は変わらないもの 数えない 文書・CI・テスト・開発の道具だけの変更(アプリの中身が変わらないもの) - minor か patch かは、その機能そのものが前のバージョンに無かったかで分けます。今ある機能で扱えるもの・使える場面を増やしただけなら、PR のタイトルが
feat:でも、機能の改善なので patch です(オーナーの指示。2026-10-15)。- 例: 入力欄の
@で渡せるものに、ワークスペースに追加したフォルダのファイルを足した(#215)のは、@で渡す機能がもとからあるので patch(v1.7.1)。ワークスペースにフォルダを追加できるようにした(#212)のは、その機能そのものが無かったので minor(v1.7.0)
- 例: 入力欄の
- 数えない変更しか無いときは、リリースしなくてよいかもしれないと伝え、patch を推奨にして聞きます。
- 0.x の間に major に当たる変更があったときも、そのまま major(1.0.0)を推奨にします。1.0.0 は節目なので、説明に理由をはっきり書きます。
- 聞く前に、変更ごとの分け方(PR の番号・タイトル・上げ方・理由を一言)を文章で見せます。
- AskUserQuestion の選択肢は patch・minor・major の 3 つ。ラベルは
0.3.0(minor)のように新しいバージョンと上げ方を並べ、提案を先頭にして末尾に「(推奨)」。説明には、そのバージョンにする理由(推奨でないものは、選ぶとしたらどんなときか)を書きます。
- 変更点を、下の「変更点の書き方」の形でまとめます。2 の PR の本文と、5 の下書きの説明に使います。
変更点の書き方
読むのは tanacode を使う人。「何が変わって、自分に関係あるか」が 10 秒でわかることを目指します。長い箇条書きを並べず、表で一覧にし、説明が要るものだけ後ろで詳しく書きます。
<まとめ>
## 変更点
| 種類 | 内容 | PR |
| --- | --- | --- |
| 追加 | <一行> | #39 |
| 変更 | <一行> | #38 |
| 修正 | <一行> | #35 |
| その他 | <一行> | #37 |
## 詳しく
### <表の内容と同じ一行>
<一、二文の説明>
- <補足>- まとめ: 見出しを付けず、説明のいちばん上に 1〜2 文。
v0.1.6 から 4 つの変更。のように数を言い、いちばん大きい変更を一言で。 - 表
- 種類は 4 つだけ。「追加」(新しい機能)・「変更」(今までの動きや見た目が変わる)・「修正」(不具合の修正)・「その他」(動作確認済の Claude Code の更新など、使う人に関わる小さなもの)。この順に並べます。
- 内容は一行(40 文字くらいまで)。使う人の言葉で、何ができるようになったか・どう変わったかを書きます。「〜できるようにする」より「〜できる」のように、今の状態で書きます。
- PR は
#39の形(GitHub がリンクにします)。 - 載せないもの: バージョンを上げる PR、文書・CI・テスト・開発の道具だけの変更。これらは末尾の畳んだ「PR の一覧」に残るので、それで足ります。
- 前のリリースに無かった機能への直しは、行にしません。同じバージョンの中で足した機能を、リリースの前に直した PR(不具合・見た目・動きの調整)は、使う人から見れば初めからその形の機能です。「修正」「変更」には載せず、その機能の行の PR に番号を足し(
#62・#75)、内容と「詳しく」は直したあとの形で書きます。- 例: コンテキストの圧縮を選べる機能を足し(#62)、リリースの前に見た目を直した(#75)→「追加 | コンテキストの中身を見て、圧縮で残すもの・捨てるものを選べる | #62・#75」の 1 行だけ
- 見分け方: 直した機能が前のタグにあったかを確かめます。その機能を足した PR が前のタグより後にマージされていれば新しい機能です。迷ったら
git grep <機能の言葉> <前のタグ> -- GUIDE.md srcで、前のタグの文書やソースにあるかを見ます。 - 1 つの PR が前からある機能と新しい機能の両方を直しているときは、前からある機能の分だけを「修正」に書きます。
- 新しい機能を広げる PR(新しい機能の上に、別の機能を足すもの)は、これまでどおり「追加」の行にしてかまいません。
- 詳しく
- 表の一行で伝わらないものだけ。足りれば節ごと省きます。
- 見出しは表の内容と同じ一行にして、表から探せるようにします。
- 一、二文の説明のあとに、箇条書きを 5 つまで。入れ子にしません。
- 使い方(どこを押すか)・気をつけること・前との違いを書きます。原因やコードの中の仕組みは書きません(PR に書いてあります)。
- 使う人に関わる変更が 1 つも無いときは、まとめに「使う人から見た変更は無し」と書き、表と「詳しく」は省きます。
2. バージョンを上げる PR
ブランチを作り、バージョンを上げます。
npm versionはpackage.jsonとpackage-lock.jsonの両方を書き換えます。git switch -c release/vX.Y.Z npm version X.Y.Z --no-git-tag-version git diff --stat確かめること
git diff --statに出るのがpackage.jsonとpackage-lock.jsonの 2 つだけ- 型チェックとテストは、手元では流しません。この PR の CI(4)で流れ、
release.ymlは流しません(develop に入っているかだけを見ます)
コミットしてプッシュし、develop 向けの PR を作ります。コミットメッセージと PR は日本語。
git commit -am "chore: vX.Y.Z にする" git push -u origin release/vX.Y.Z gh pr create --base develop --title "chore: vX.Y.Z にする" --body-file <本文のファイル>PR の本文には、1 でまとめた変更点の一覧(PR の番号付き)。本文のファイルは
mktempなどで作る一時ファイルに。- PR の URL をユーザーに伝えます。
CI がすべて終わるまで待ちます。
gh pr checks <PR の番号> --watch確かめること
- すべて
pass(skippingは可。たとえば PR では動かないupdateジョブ) gh pr view <PR の番号> --json mergeStateStatus --jq .mergeStateStatusがCLEAN- どれかが
failなら、マージせずに止めて、ユーザーに伝えます(このブランチでは直しません)
- すべて
通っていれば、squash マージします。ユーザーには聞きません。
gh pr merge <PR の番号> --squash gh pr view <PR の番号> --json state,mergeCommit --jq '{state, oid: .mergeCommit.oid}'stateがMERGEDになるまで先へ進みません。待っているあいだにオーナーが先にマージしていたときは、そのまま「3. タグを付けてプッシュ」へ進みます。閉じられた(CLOSED)ときは止めて、ユーザーに伝えます。
cloud では
- プッシュは
git push -u origin release/vX.Y.Zのまま(ブランチは通ります)。PR はmcp__github__create_pull_requestで作ります。 - CI は
mcp__claude-code-remote__subscribe_pr_activityで PR を見張り、終わった知らせを待ちます(Bash のsleepで待ちません)。知らせが来たら、mcp__github__pull_request_readのget_check_runsですべてsuccess(skippedは可)、getでmergeable_stateがcleanかを確かめます。 - マージは
mcp__github__merge_pull_request(merge_method: squash、expectedHeadShaに PR の head の SHA)。返事のshaがマージコミットです。マージしたら PR の見張りを外します(unsubscribe_pr_activity)。
3. タグを付けてプッシュ
develop を最新にし、マージされたコミットにいることを確かめます。
git switch develop git pull --ff-only git rev-parse HEAD node -p 'require("./package.json").version'確かめること
git rev-parse HEADが、PR のmergeCommit.oidと同じversionがX.Y.Z(ずれていると Actions の「バージョンを確かめる」で止まります)
注釈付きのタグを付けます。
git tag -a vX.Y.Z -m "vX.Y.Z" <mergeCommit.oid>タグをプッシュします(プッシュすると Actions が動き出します)。
git push origin vX.Y.Z
cloud では
タグは付けず(プッシュは 403 で断られます)、release.yml を手動で起動します。ワークフローがビルドの通ったコミットにタグを付けます。
- 1 と同じく develop を最新にし、
git rev-parse HEADがマージコミットと同じことを確かめます。違う(マージのあとに別のコミットが入った)ときは、そのコミットもリリースに入るので、止めてユーザーに伝えます。 mcp__github__actions_run_triggerで起動します。項目 値 methodrun_workflowworkflow_idrelease.ymlrefdevelopinputs{"version": "X.Y.Z"}- ワークフローは、develop から起動したか・
X.Y.Zの形か・同じタグがまだ無いかを先に確かめ、合わなければビルドの前に止まります。 - 「バージョンを確かめる」で
package.jsonのversionと比べるのは、タグのプッシュのときと同じです。
- ワークフローは、develop から起動したか・
4. Actions の見守り
起動した run を探します。プッシュの直後は一覧に出ないことがあるので、数秒おいて確かめ直します。
gh run list --workflow release.yml --limit 1 --json databaseId,headBranch,status,urlheadBranchがvX.Y.Zのものが今回の run。終わるまで見守ります。数分〜10 分ほどかかるので、Bash の
run_in_backgroundで動かします。gh run watch <run の id> --exit-status失敗したら、ログを読んで原因を確かめます。
gh run view <run の id> --log-failed症状 原因と対処 画面側のビルドで JavaScript heap out of memoryNode のメモリ不足。手元のビルドは約 4GB 使い、ランナーの既定の上限(約 2GB)では止まります。v0.1.2 のときに起き、 release.ymlのnpm run releaseにNODE_OPTIONS: --max-old-space-size=6144を付けました。消えていないか確かめ、足りなければ上限を上げる直しを PR で入れ、7 の手順で作り直し「バージョンを確かめる」で止まる タグと package.jsonのversionのずれ。タグを付けたコミットの取り違えか、バージョンを上げる PR がまだマージされていないかのどちらか。7 の手順でタグを付け直し「翻訳の補助プログラムを作れませんでした」、または「翻訳の補助プログラムを確かめる」で止まる チャットの翻訳の補助プログラム(Swift)を作れなかったか、アプリに入らなかった。ランナーの swiftc(Xcode)かnative/translate/main.swiftのコンパイルエラーをログで確かめ、直しを PR で入れ、7 の手順で作り直しnpm ciやダウンロードの一時的な失敗コードを変えずに gh run rerun <run の id> --failedで再実行「Releases の下書きを作る」で GitHub の 5xx 返事がエラーでも、GitHub 側では下書きができていることがあり、すぐには一覧に出ません。このステップは、作り直す前に残った下書きを消し、もう一度作ります。それでも止まったときは、コードを変えずに gh run rerun <run の id> --failedで再実行(再実行でも、作る前に残りを消します)。あとから残りが出てきても、5 のスクリプトが添付で見分けますそのほか ログの要点をユーザーに伝えて、どうするか AskUserQuestion で確かめます
5. 下書きの点検
点検と公開は、scripts/release-publish.sh で行います(cloud の release-publish.yml も同じスクリプトを使います)。リリースを手で打った命令で公開しません。
- タグで選んで公開しない(
gh release edit vX.Y.Z --draft=falseなど)。同じタグに下書きが 2 つあると、点検していない方が選ばれます(v2.8.1 で、添付の無い方が公開された) - ID で選ぶときも、タグ名を必ず渡す。渡さないと、GitHub は下書きの仮の名前(
untagged-…)でタグを作って公開します(v2.8.2 の 1 回目) - 公開したリリースは immutable で、添付もタグ名もあとから変えられず、消しても同じタグ名を使い直せません。だから点検は公開の前に、確かめは公開のあとにもします
下書きの様子を見ます。下書きは
gh release view vX.Y.Zでは見つからないことがあるので、API で見ます。gh api repos/sny-tanaka/tanacode/releases --jq '.[] | select(.tag_name == "vX.Y.Z") | {id, draft, html_url, assets: [.assets[].name]}'下書きが 2 つ以上あるとき(失敗した試みの残り)も、スクリプトは添付が 5 つそろったものだけを選び、ほかは使わずに知らせます。残りを消すかは、公開のあとでユーザーに聞きます。
- 変更点(まとめ・「## 変更点」・「## 詳しく」)を、1 の 4 でまとめた形で一時ファイルに書きます。聞かずに毎回足します。
スクリプトに渡します。点検がすべて通ったときだけ、説明の先頭に変更点を足して公開し、最新のリリースにします。
scripts/release-publish.sh X.Y.Z <変更点のファイル>スクリプトが確かめること(どれかが合わなければ、何も変えずに
::error::で止まります)- このタグの公開済みのリリースが無いこと
- 添付が次の 5 つそろった下書きが、ちょうど 1 つあること。ファイル名が README のダウンロードの表と合っていること
tanacode-X.Y.Z-mac-arm64.pkg・tanacode-X.Y.Z-mac-arm64.ziptanacode-X.Y.Z-mac-x64.pkg・tanacode-X.Y.Z-mac-x64.zipSHA256SUMS.txt
- 説明が
## ダウンロードから始まり、ダウンロードの表のファイル名が添付と合うこと - 説明の SHA-256 の表と
SHA256SUMS.txtの値が一致すること - 公開のあと: タグで引いたリリースが点検した下書き(同じ ID)で、下書きでなく、添付が 5 つあり、最新のリリースがそのタグであること
cloud では
- 下書きは
mcp__github__list_releases(fieldsはid・tag_name・draft・html_url)で読み、tag_nameがvX.Y.Zのものを見ます。 - 点検と公開は、6 で
release-publish.ymlがscripts/release-publish.shで行います。変更点は、ここでは書き込まず、6 で渡します。
6. 公開
- 5 の 3 のスクリプトが公開まで行います。止まったときは公開されていません。
::error::の行と下書きの URL を見せ、AskUserQuestion でどうするか確かめます。 - スクリプトが「公開を確かめられません」で止まったときは、公開の返事がエラーでも GitHub 側では公開されていることがあります。
gh api repos/sny-tanaka/tanacode/releases --jq '.[] | select(.name == "vX.Y.Z") | {id, tag_name, draft, assets: [.assets[].name]}'で、どのリリースがどの状態かを見て、ユーザーに伝えます(公開済みのものは直せないので、7 の「公開したあと」)。 新しいバージョンになったか確かめます。
gh api repos/sny-tanaka/tanacode/releases/latest --jq .tag_name curl -s https://img.shields.io/github/v/release/sny-tanaka/tanacode | grep -o '<title>[^<]*</title>'1 つめが
vX.Y.Z、2 つめが<title>release: vX.Y.Z</title>なら公開は完了。README の「最新バージョン」のバッジはこの shields.io の画像。shields.io はキャッシュするので、古いバージョンのままなら数分おいて確かめ直します。Homebrew の tap の cask を新しいバージョンにします。手元の公開は
release-publish.ymlを通らないので、homebrew.ymlを develop で起動し、4 と同じ要領で見守ります(10 分ほど)。gh workflow run homebrew.yml --ref develop -f version=X.Y.Z通れば、
https://github.com/sny-tanaka/homebrew-tanacode/blob/HEAD/Casks/tanacode.rbのversionがX.Y.Zになります。失敗したときは「Homebrew の cask」の表へ。
cloud では
mcp__github__actions_run_triggerでrelease-publish.ymlを起動します。項目 値 methodrun_workflowworkflow_idrelease-publish.ymlrefdevelopinputs{"version": "X.Y.Z", "notes": "<1 の 4 でまとめた変更点(Markdown)>"}- ワークフローは、5 の 3 と同じスクリプト(
scripts/release-publish.sh)で点検し、notesを先頭に足して公開し、最新のリリースにします。 - どれかが合わなければ、何も変えずに止まります。ログの
::error::の行を見て、公開せずにユーザーに伝え、AskUserQuestion でどうするか確かめます。
- ワークフローは、5 の 3 と同じスクリプト(
- 4 と同じ要領で run を見守ります(1 分ほどで終わります)。
mcp__github__get_latest_releaseのtag_nameがvX.Y.Zで、本文の先頭に変更点が入っていれば公開は完了。shields.io のバッジはcurlで 3 と同じく確かめます。release-publish.ymlは、公開のあとにhomebrewのジョブ(homebrew.yml)で Homebrew の tap の cask を新しいバージョンにします。このジョブは 10 分ほどかかるので、終わるまで見守ります。通れば、mcp__github__get_file_contents(sny-tanaka/homebrew-tanacodeのCasks/tanacode.rb)のversionがX.Y.Zになります。失敗したときは「Homebrew の cask」の表へ。
Homebrew の cask
homebrew.yml は、公開済みのリリースの zip の SHA-256 を SHA256SUMS.txt と照らし、tap(sny-tanaka/homebrew-tanacode)の Casks/tanacode.rb の version と sha256 を書き換えます。プッシュの前に、ランナーの Mac でその cask から入れて、バージョンと quarantine 属性を確かめます。リリースそのものは公開済みなので、ここで失敗しても公開は取り消しません。直してから、develop で homebrew.yml を version に X.Y.Z を渡して起動し直します(cloud では mcp__github__actions_run_trigger、workflow_id は homebrew.yml)。
| 症状 | 原因と対処 |
| 「tap の token を作る」で止まる | GitHub App の設定。Environment「homebrew」の HOMEBREW_TAP_APP_CLIENT_ID(変数)・HOMEBREW_TAP_APP_PRIVATE_KEY(シークレット)と、App が homebrew-tanacode にインストールされているかを、ユーザーに確かめてもらいます |
| ジョブが始まらず、Environment の保護で止まる | develop 以外で起動した。develop で起動し直し |
| 「cask で入れて確かめる」で止まる | ログの ::error:: の行を見ます。Homebrew の書き方の変更(postflight_steps など)なら、tap の Casks/tanacode.rb の直しをユーザーに伝え、AskUserQuestion でどうするか確かめます |
| ダウンロードの一時的な失敗 | コードを変えずに、失敗したジョブを再実行 |
7. 失敗して作り直すとき
公開する前: タグを消し、直しを PR で develop に入れてから、3 の手順でタグを付け直します。タグの削除は AskUserQuestion で確かめてから。
git tag -d vX.Y.Z git push origin :refs/tags/vX.Y.Z失敗した run が残した作りかけの下書きは、次の run の「Releases の下書きを作る」が、作る前に消します(このタグの下書きは、このワークフローしか作らないため)。
- cloud で公開する前: タグと下書きは、cloud からは消せません。ユーザーに、手元で
git push origin :refs/tags/vX.Y.Zを実行してもらいます(AskUserQuestion で確かめてから頼みます。残った下書きは、次の run が作る前に消します)。消えたことをgit ls-remote --tags origin vX.Y.Zで確かめ、直しを PR で入れてから、3 の「cloud では」で起動し直します。 - 公開したあと: タグは付け直しません。直しを PR で入れ、バージョンを上げて(例:
X.Y.Zの次の patch)、1 からやり直します。利用者がすでにダウンロードしているためです。
補足
- 配布物を手元で作るなら
npm run release。release/に Apple Silicon 用と Intel 用の zip と pkg を作ります(自己署名の証明書で署名。キーチェーンに無いと止まります)。使っているdist/と/Applicationsには触れません。翻訳の補助プログラムを作るので、swiftc(Xcode Command Line Tools)が要ります(無いと止まる)。 - パッケージ版は本物の userData と Remote Control 付きで動くので、手元で作ったものを試しに起動しないでください。
最後の報告
ユーザーに、次をまとめて伝えます。
- リリースの URL(
https://github.com/sny-tanaka/tanacode/releases/tag/vX.Y.Z) - 引数を省いたときは、提案した上げ方とその理由、選ばれたバージョン
- バージョンを上げた PR の URL と、Actions の run の URL
- 点検の結果(添付 5 つ・SHA-256 の一致・ファイル名)
- 説明に足した変更点の有無
- Homebrew の tap の cask が
X.Y.Zになったか - 途中で起きた失敗と、その対処(あれば)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

