[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6C4RKWJFTJYXF61YCV3P84G":3,"skill-same:01M6C4RKWJFTJYXF61YCV3P84G":109},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":28,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M6C4RKWJFTJYXF61YCV3P84G","harness-release",null,"Generic release automation for projects using Keep a Changelog + GitHub. Single confirmation gate then end-to-end automation: bump detection, CHANGELOG promotion, PR\u002Fmain merge, tag, GitHub Release. Trigger: release, version bump, publish. Do NOT load for: implementation, review, planning, setup.","Chachamaru127\u002Fclaude-code-harness","Chachamaru127","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F96473544?v=4","01M6C4N084DDDEK9SJPGFG9H9M","Chachamaru","01M6C4N0CCNFST9P8C7EJNVH42",3209,"MIT","https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"release","harness","harness release","detection","generic","for","promotion","trigger","end","main","do","bump","version","confirmation","projects","review","github release","publish","changelog","planning","pr","setup","merge","automation","github","2026-11-10 10:12:30",false,"---\nname: harness-release\ndescription: \"Generic release automation for projects using Keep a Changelog + GitHub. Single confirmation gate then end-to-end automation: bump detection, CHANGELOG promotion, PR\u002Fmain merge, tag, GitHub Release. Trigger: release, version bump, publish. Do NOT load for: implementation, review, planning, setup.\"\n---\n\n# Harness Release (汎用)\n\nKeep a Changelog + GitHub を使う**あらゆるプロジェクト向け**の汎用リリース自動化スキル。\n\n**設計原則**: 単一確認ゲート。ユーザーは 1 回だけ全体計画を見て承認する。承認後はファイル書き換え → commit → branch push → PR 作成\u002F更新 → default branch へ merge → default branch 上で tag → GitHub Release までを中断なく実行する。\n\n**Release complete の定義**: release は「tag と GitHub Release を作った」だけでは完了ではない。対象 work と release bump が default branch（通常 `main`）に merge 済みで、release tag が default branch 到達可能 commit を指し、GitHub Release がその tag を公開している状態を完了とする。\n\n## PR ready vs release ready\n\nHarness V2 では PR closeout と release closeout を混同しない。\n\n| Gate | 意味 | 必須条件 | 停止 lane |\n|------|------|----------|-----------|\n| **PR ready** | ブランチが review 可能で merge 判断できる | `harness-review` `APPROVE`、focused tests PASS、evidence pack 完備（accepted\u002Frejected findings、tests、release-preflight warnings 処理、residual risk） | `[lane:fast]` \u002F `[lane:gate]` はここで停止可 |\n| **release ready** | 公開配布 path が preflight を通過 | PR ready 条件 + version surface sync + tag + GitHub Release + CI\u002Fpublic artifact 検証 | `[lane:release]` のみ |\n\n- PR ready は `harness-review` APPROVE + evidence pack で判定する。`harness-review` から push \u002F PR \u002F merge はしない。\n- release ready は `harness-release` の Preflight \u002F Post-Gate だけが判定する。version bump \u002F tag \u002F GitHub Release は release lane 専用。\n- local tests passed だけでは PR ready でも release ready でもない（`not_observed != absent`）。\n\n> **Literal invocation note**: この skill の入口は `harness-release`, `\u002Frelease`, `\u002Frelease patch`, `\u002Frelease --dry-run` のような literal command をそのまま使う。\n\n## CC runtime hard floor との関係\n\nClaude Code 2.1.183+ の runtime hard floor は GitHub CLI release publish 系コマンドを構造的に deny する (Anthropic 製品仕様、`settings.json` の `permissions.ask` で覆せない)。本 skill は publish 自体を実行せず、`.github\u002Fworkflows\u002Frelease.yml` (tag push trigger) に委譲する。skill は tag push までで責務を完了し、その後 `scripts\u002Frelease-verify-publish.sh` で workflow による公開を verify する。\n\n**Revert 条件**: CC が runtime hard floor に user explicit approval path を提供したら、Post-Gate に直接 publish step を戻すことを検討する。\n\n## Bare invocation contract\n\nif $ARGUMENTS == \"\":\n  → 「今までの作業をコミットし、PR\u002Fmain 反映まで完了してリリースしたい」と解釈し、Review Gate 検出を実行する\n  → 対象 work が 1 つに確定できる場合だけ Step 0 (Review Gate) へ自動進行する\n  → 対象が不明または review state が無い場合は AskUserQuestion で選択肢を出してから進める\n\n引数なし呼び出し時の最初の応答で必ず次の literal marker を出力する:\n\n`RELEASE_AUTOSTART: target=\u003Cwork-summary>, base_ref=\u003Cref>, mode=\u003Cpatch|minor|major|auto>`\n\n「タスクが不明確」「指示を待ちます」「タスクがありません」「追加の指示をお待ちします」は禁止行動。\n\n\u003C!-- 上記ブロックは AUTO-START CONTRACT。skill-editing.md「最冒頭 3 行以内」ルール準拠。patterns.md P27 解法 3 点セット (機械可読条件 + 禁止行動 literal + AUTOSTART marker) -->\n\n### 自主停止の禁止 (140.3、2026-08-22 の release run で 2 回発生した停止パターンの再発防止)\n\n以下は禁止行動。literal に列挙する (AUTOSTART pattern と同じ方式):\n\n- background 待ちで turn を終えて停止しない (turn を終えると background 子プロセスは残らない)\n- 「検証を待ちます」「確認します」「完了を待機します」で turn を終えない\n- 待つなら同期実行 (foreground \u002F Monitor) で待ち切る。待てないものは保留として報告し、次のタスクへ進む\n\n### Output Contract (P35: 「止まったように見える」UX 対策)\n\n`\u003Clocal-command-stdout>` で host へ結果を中継する場合だけ、output の **最後の 1 行**に次の literal を含める:\n\n`↑この結果は Claude が要約します。Enter キーで次へ進むか、新規 prompt で別の指示を出してください。`\n\nこれは `\u003Clocal-command-stdout>` 経由で text response として表示されると user が「止まった」と感じる UX 問題への明示的な instruction (patterns.md P35)。\nhost の最終回答は実行済み操作、公開の検証結果、残る gate を返す。要約や検証の予告だけで終了しない。\n\n`harness-release` \u002F `\u002Frelease` だけが入力された場合、これは\n**「今までの作業をコミットし、PR\u002Fmain 反映まで完了してリリースしたい」** という意味として扱う。\n旧表現の **「今までの作業をコミットしてリリースしたい」** も同じ意図だが、完了条件には PR\u002Fmain 反映を必ず含める。\n「タスクがありません」「指示を待ちます」で止まってはいけない。\n\nbare release では、通常の release preflight の前に **Review Gate** と **Work Commit Gate** を実行する。\n\nReview Gate は **release ready** 向け。`[lane:fast]` \u002F `[lane:gate]` の PR ready だけが必要な work には、ユーザーが release を明示しない限り `harness-release` を起動しない。\n\n1. `git status --porcelain` と `git log @{upstream}..HEAD` \u002F `main..HEAD` を確認し、「今までの作業」の対象を特定する\n2. `.claude\u002Fstate\u002Freview-result.json` と `.claude\u002Fstate\u002Freview-approved.json` を確認し、対象 work に `APPROVE` 済み review と evidence pack があるか確認する\n3. APPROVE 済み review が無い場合は `AskUserQuestion` で確認する\n4. ユーザーが「レビューから開始」を選んだら、`harness-review` を起動し、`APPROVE` になるまで release へ進まない\n5. `harness-review` が `REQUEST_CHANGES` を返した場合は release を保留し、`harness-work` で修正してから `harness-review` を再実行する。これを `APPROVE` までループする\n6. `harness-review` が `APPROVE` を返した後、working tree の作業 commit を作る\n7. working tree clean になってから通常の release preflight \u002F confirmation gate \u002F PR merge \u002F tag \u002F GitHub Release へ進む\n\n### Review Gate AskUserQuestion\n\n`harness-release` 実行時に review approval が確認できない場合は、推測で release しない。\n次の Ask を出す。\n\n```text\nquestion: \"harness-release は今までの作業をコミットしてリリースしますが、この作業の APPROVE review が見つかりません。どう進めますか？\"\noptions:\n  - label: \"レビューから開始 (Recommended)\"\n    description: \"harness-review を実行し、APPROVE になった場合だけ commit\u002Frelease へ進みます。\"\n  - label: \"release dry-run\"\n    description: \"ファイルを書き換えず、release 計画と不足 gate だけ確認します。\"\n  - label: \"中止\"\n    description: \"review も release も行わず止めます。\"\n```\n\nユーザーが「レビューから開始」を選んだ場合は、同じセッション内で `harness-review` から始める。\n`harness-review` の対象決定は `harness-review` 側の bare review contract に従う。\nreview が `APPROVE` なら、そのまま `harness-release` の Work Commit Gate へ戻る。\nreview が `REQUEST_CHANGES` なら release は保留し、`harness-work` で修正してから `harness-review` を再実行する。\nこの修正後再レビュー loop は `APPROVE` まで継続する。\n\nユーザーに戻してよいのは次の場合だけ。\n\n1. 修正に仕様正本 \u002F Plans.md \u002F API \u002F permission \u002F migration \u002F billing などの意思決定が必要で、`AskUserQuestion` が必要\n2. 修正方針が複数あり、どれを採るかでユーザー価値や互換性が変わる\n3. ユーザーが Ask で `release dry-run` または `中止` を選んだ\n\n`REQUEST_CHANGES` 単体を最終停止理由にしてはいけない。\n\n### Work Commit Gate\n\nbare release で working tree に未コミット変更がある場合、release version bump commit とは別に、\nreview 済み work commit を先に作る。\n\n```bash\ngit status --short\ngit diff --stat\ngit add \u003Creviewed files>\ngit commit -m \"\u003Ctype>: \u003Csummary>\"\n```\n\ncommit message は review summary \u002F Plans.md task \u002F branch name から短く生成する。\n表現だけが未決なら既存の commit 規約に沿って生成する。review 済みの対象そのものが曖昧な場合だけ、その対象を確認する。\nwork commit 作成後に `.claude\u002Fstate\u002Freview-result.json` の `commit_hash` を確認または更新し、\nrelease preflight へ進む。\n\n通常の release preflight に入った後は、これまで通り working tree dirty を fail とする。\ndirty tree のまま version bump \u002F tag \u002F GitHub Release に進まない。\n\n## Quick Reference\n\n```bash\n\u002Frelease              # 今までの作業を review gate → commit → PR\u002Fmain merge → release する\n\u002Frelease patch        # bump を patch に明示指定\n\u002Frelease minor        # bump を minor に明示指定\n\u002Frelease major        # bump を major に明示指定\n\u002Frelease --dry-run    # 計画の表示のみ、実行しない\n```\n\n## 前提条件\n\nこのスキルが動くプロジェクトは以下を満たす必要があります:\n\n1. `CHANGELOG.md` が [Keep a Changelog](https:\u002F\u002Fkeepachangelog.com\u002F) 形式\n2. `[Unreleased]` セクションが存在する\n3. 以下のいずれかの version file を持つ:\n   - `VERSION` (単独ファイル)\n   - `package.json` (npm)\n   - `pyproject.toml` (Python, `[project]` または `[tool.poetry]`)\n   - `Cargo.toml` (Rust, `[package]`)\n4. `gh` CLI がインストール済みで、認証済み\n5. git リモート `origin` が GitHub を指す\n6. Claude Code plugin project の場合は、`claude` CLI が `plugin validate` をサポートしている\n\nこれらが満たされない場合、Preflight で detect して abort します。\n\n`prUrlTemplate` による multi-host review URL は将来候補として認識するが、\nこのスキルの release automation は今も `gh` CLI と GitHub remote を primary path とする。\nowner \u002F branch \u002F release asset \u002F CI metadata の自動取得は host ごとの差が大きいため、Phase 56.2.3 では docs-only に留める。\n\n## 単一ゲートフロー\n\nBare release（0. Review Gate → 0.5 Work Commit Gate）→\nPre-Gate（1. Preflight → 2. Version file 検出 → 3. バージョン読み取り → 4. plugin version sync preflight → 5. bump 推定 → 6. 新バージョン算出 → 7. CHANGELOG ドラフト → 8. CHANGELOG release body preview）→\n**単一確認ゲート**（下記「Confirmation Gate」参照、`yes` \u002F `\u003C修正指示>` \u002F `cancel` の 3 択）→\nPost-Gate（9. Version file 書き換え → 10. CHANGELOG 昇格 → 11. commit → 12. branch push → 13. PR 作成\u002F更新 → 14. default branch merge → 15. 到達可能性確認 → 16. semver tag → 17. tag push → 18. workflow publish verify → 19. 完了報告）\nの 3 段階で進む。各段の詳細は「Pre-Gate 詳細」「Confirmation Gate」「Post-Gate 詳細」を参照。\n\n## Pre-Gate 詳細\n\n### 1. Preflight\n\nrelease ready gate: PR ready 条件に加え、version \u002F tag \u002F GitHub Release \u002F CI artifact path を確認する。\n\n```bash\n# 必須ツール\ncommand -v gh >\u002Fdev\u002Fnull || { echo \"gh CLI がありません\"; exit 1; }\ncommand -v python3 >\u002Fdev\u002Fnull || { echo \"python3 が必要です\"; exit 1; }\n\n# working tree\nif [ -n \"$(git status --porcelain)\" ]; then\n  echo \"working tree に未コミット変更があります\"; exit 1;\nfi\n\n# CHANGELOG\n[ -f CHANGELOG.md ] || { echo \"CHANGELOG.md がありません\"; exit 1; }\ngrep -q \"^## \\[Unreleased\\]\" CHANGELOG.md || { echo \"[Unreleased] セクションがありません\"; exit 1; }\n\n# plugin\u002Fmirror projects\nscripts\u002Frelease-preflight.sh\n```\n\nこの working tree clean check は通常 release preflight の gate である。\nbare release で「今までの作業」を commit したい場合は、この check の前に Review Gate と Work Commit Gate を完了させる。\n未レビューの dirty tree をこの check だけで abort して終わらせてはいけない。\n\n`scripts\u002Frelease-preflight.sh` は tag 作成前に `opencode\u002F`, `skills-codex\u002F`, `codex\u002F.codex\u002Fskills\u002F` の mirror drift も検出する。`node scripts\u002Fbuild-opencode.js` が差分を生成した場合は release を止め、その差分を commit してから tag に進む。\n\nrelease preflight は host workflow smoke を `REQUIRED=1`（fail-closed）で全 dist host に対して実行する。1 host でも FAIL なら release を止める。これは multi-host bar H7（release-preflight consumes host gates fail-closed）の充足配線である。`scripts\u002Frelease-preflight-host-smoke.sh` 参照。fail-closed の正本は operator マシンの preflight であり、GitHub runner（`GITHUB_ACTIONS=true`）では CLI 未 provision の host を明示 SKIP 行つきで飛ばす（tag-triggered workflow の再実行が全 release を塞がないため。v5.3.0 run 29679591686 の regression 対応）。\n\n### 2. Version File 自動検出\n\n`VERSION` → `package.json` → `pyproject.toml`（`[project]` \u002F `[tool.poetry]`）→ `Cargo.toml` の優先順で探索し、最初に見つかったものを正本とする。\n検出スニペット・読み取りロジックの詳細: [version-files.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fversion-files.md)\n\n### 3. Claude Plugin Version Sync Preflight\n\n`.claude-plugin\u002Fplugin.json` が存在する project では、semver tag を切る前に plugin manifest の validation と全 version surface の同期を確認する。\n\n> **plugin tag (`{plugin-name}--v{version}`) は 2026-08-17 に廃止**。`marketplace.json` の `source` が相対パス (`\".\u002F\"`) で install は tag を参照しないため、実効性が無いまま v5.6.0 以降 3 リリース連続で欠番になっていた。GitHub Release 用 semver tag `vX.Y.Z` に一本化する (decisions.md D69)。\n\nPre-Gate ではファイルを書き換えず、以下を確認する。\nversion sync は `grep` \u002F `sed` で拾わず、JSON は structured parser で読む:\n\n```bash\ncommand -v claude >\u002Fdev\u002Fnull || { echo \"claude CLI がありません\"; exit 1; }\nclaude plugin validate .claude-plugin\u002Fplugin.json\n\nHARNESS_PLUGIN_ROOT=\"${CLAUDE_PLUGIN_ROOT:-.}\"\npython3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root .\n```\n\n`${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py` は、存在する release surface をすべて読み取り、canonical を `VERSION > package.json > .claude-plugin\u002Fplugin.json > .codex-plugin\u002Fplugin.json` の順で決める。\nそのうえで、以下の不一致・欠落が 1 つでもあれば tag \u002F release に進まない:\n\n- `VERSION`\n- `package.json` の `.version`\n- `.claude-plugin\u002Fplugin.json` の `.version`\n- `.codex-plugin\u002Fplugin.json` の `.version`\n- `.claude-plugin\u002Fmarketplace.json` の `.metadata.version`\n- `.claude-plugin\u002Fmarketplace.json` の `.plugins[].version`（配列内の各 plugin entry）\n\n不一致時は、どの surface が canonical と違うか、またはどの field が missing \u002F invalid かを表示する。\n機械処理や CI で読む場合は `--json` を使う:\n\n```bash\npython3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root . --json\n```\n\nこの check は 3 つの事故を防ぐためにある:\n\n- `VERSION` と `.claude-plugin\u002Fplugin.json` の version がずれたまま tag を切る事故\n- `package.json` \u002F marketplace entry の version が古いまま release workflow に進む事故\n- plugin manifest \u002F marketplace entry の validation を通さず、あとで plugin install \u002F update 側で詰まる事故\n\nこの check の結果 (canonical version と各 surface の一致) を Confirmation Gate の plan に含める。\n\n### 4. Bump 自動推定\n\n`[Unreleased]` 直下の見出し（`### Breaking Changes`\u002F`### Removed` → major、`### Added` → minor、`### Fixed`\u002F`### Changed`\u002F`### Security` のみ → patch、空セクション → error）を解析して bump level を決定する。\nユーザーが `\u002Frelease patch|minor|major` で明示指定した場合はそちらを優先。\n詳細: [bump-detection.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fbump-detection.md)\n\n### 5. CHANGELOG ドラフト作成 (メモリ上)\n\n`[Unreleased]` の内容を切り出し、`[\u003Cnew>] - YYYY-MM-DD` セクションと compare link を組み立てる（まだ書き込まない）。\n詳細: [release-notes.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Frelease-notes.md#changelog-ドラフト作成メモリ上pre-gate-ステップ-7)\n\n### 6. CHANGELOG release body preview (メモリ上)\n\ntag-triggered workflow が公開する本文は、昇格後の `## [\u003Cnew>]` セクション本文そのもの。\n別の英訳・要約・フッターを生成せず、workflow と同じ抽出境界の本文をそのまま preview する。\n抽出方法・検証チェックの詳細: [release-notes.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Frelease-notes.md)\n\n## Confirmation Gate\n\nすべてのドラフトが揃ったら、ユーザーに 1 回だけ提示:\n\n```\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nRelease Plan: v\u003Cold> → v\u003Cnew> (\u003Cbump>)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n Version file: \u003Cdetected file>\n Bump reason:  \u003Cwhy this level was chosen>\n\n CHANGELOG changes:\n   [Unreleased] に \u003CN> 項目の変更を検出\n   [\u003Cnew>] - YYYY-MM-DD として確定\n   Compare link を追加\n\n CHANGELOG release body preview (workflow が公開する本文):\n   \u003Cworkflow が公開する本文の全行>\n\n Files to modify:\n   - \u003Cversion file>\n   - CHANGELOG.md\n\n Final actions:\n   - git commit -m \"chore: release v\u003Cnew>\"\n   - git push origin \u003Crelease-branch>\n   - gh pr create\u002Fupdate + gh pr merge into \u003Cdefault-branch>\n   - git fetch origin \u003Cdefault-branch> && git checkout \u003Cdefault-branch>\n   - git tag -a v\u003Cnew>                                        # GitHub Release 用 semver tag。default branch 上で作成\n   - git push origin \u003Cdefault-branch> --tags\n   - (tag push 後は GitHub Actions release workflow が自動で release 公開)\n\nProceed? [yes \u002F cancel \u002F \u003C修正指示>]\n```\n\n## Post-Gate 詳細\n\n承認後は中断なしで実行。失敗時は以下の方針:\n\n| 失敗箇所 | 復旧 |\n|---------|------|\n| ファイル書き換え失敗 | そこで abort、ローカルは dirty なまま人間が判断 |\n| commit 失敗 | hook 拒否等。ユーザーに原因を提示して修正を促す |\n| PR 作成\u002Fmerge 失敗 | release を未完了として停止。tag \u002F GitHub Release には進まない |\n| plugin version sync 失敗 | `VERSION` \u002F `.claude-plugin\u002Fplugin.json` \u002F marketplace entry の不一致を修正し、tag 作成には進まない |\n| push 失敗 | リモート側の問題。ローカル commit\u002Ftag は残す |\n\n### PR \u002F Main Merge Gate、semver tag、Verify Publish\n\nPost-Gate の release commit 後、tag を作る前に GitHub PR を default branch へ merge する（`gh pr create` → `gh pr merge --merge` → default branch fetch\u002Fcheckout で release commit の到達可能性を確認）。release branch 上だけに存在する commit を指す tag で GitHub Release を作ってはいけない。\n`.claude-plugin\u002Fplugin.json` がある project では、merge 後に default branch 上で version sync を再確認してから semver tag `vX.Y.Z` を作る (plugin tag は 2026-08-17 廃止、D69)。\ntag push 後は `bash scripts\u002Frelease-verify-publish.sh` で `.github\u002Fworkflows\u002Frelease.yml` の公開結果を verify する（5 秒間隔 × 60 回 polling、exit 0=PASS \u002F 2=WARN(timeout) \u002F 3=ERROR）。\nコマンド全文・失敗時の判断基準は [post-gate-detail.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fpost-gate-detail.md) を参照。\n\n## `--dry-run` モード\n\nPre-Gate 全てを実行し、Confirmation Gate までの内容を表示するが、**gate で止まり Post-Gate に進まない**。\n\nClaude plugin project の場合、dry-run でも `python3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root .` を実行し、canonical version と各 surface の一致を表示する。ここで `VERSION` \u002F `package.json` \u002F `.claude-plugin\u002Fplugin.json` \u002F `.codex-plugin\u002Fplugin.json` \u002F `.claude-plugin\u002Fmarketplace.json` の version surface が不一致または欠落していれば、dry-run の時点で止める。\n\n## 環境変数\n\nプロジェクトごとの調整に使用:\n\n| 変数 | 説明 |\n|------|------|\n| `HARNESS_RELEASE_PROJECT_ROOT` | リポジトリルート (デフォルト: `$(pwd)`) |\n| `HARNESS_RELEASE_BRANCH` | push 対象ブランチ (デフォルト: 現在のブランチ) |\n| `HARNESS_RELEASE_DEFAULT_BRANCH` | PR merge 先 default branch (デフォルト: `main`) |\n| `HARNESS_RELEASE_HEALTHCHECK_CMD` | Preflight で追加実行するコマンド |\n| `HARNESS_RELEASE_SKIP_GH` | `1` で GitHub publication verification をスキップ |\n\n## CHANGELOG 書き方ルール\n\n`[Unreleased]` セクションは KaCL 標準サブセクション（`### Added`=minor \u002F `### Changed`・`### Fixed`・`### Security`=patch \u002F `### Deprecated`=minor \u002F `### Removed`・`### Breaking Changes`=major）のいずれかを持つ必要がある。\nこのスキルはこれらの見出しを機械的に解析するため、表記揺れ（`### Fix` \u002F `### Bug Fixes` 等）は認識できない。\n\nCHANGELOG release body の preview 契約・CHANGELOG の書き方・merge 方式（squash 不採用）の詳細は\n[github-release.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fgithub-release.md) を参照。\nSemVer 判定基準・バッチリリース方針・Release Train Proposal の詳細は\n[versioning.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fversioning.md) を参照。\n\n## 出荷前の受け入れ判断（非エンジニア向け）\n\nリリース確定の前に `harness-accept` を提案する。各合格条件が満たされたかと ship\u002Fwait\u002Freject の\n推奨を 1 枚の HTML にまとめた「受け入れ判断」画面で、発注者が専門知識なしで出荷可否を判断できる。\n\n## 関連スキル\n\n- `harness-release-internal` - 本体 claude-code-harness のリリース時に追加で走らせる harness 固有 preflight\u002Ffinalization（配布対象外）\n- `harness-plan` - Plans.md 管理\n- `harness-review` - リリース前のコードレビュー\n- `harness-accept` - 受け入れ判断 HTML（非エンジニア向け、リリース前に提案）\n\n## 設計思想\n\n- **PR ready \u002F release ready 分離**: PR ready は review + evidence pack。release ready は version\u002Ftag\u002FGitHub Release\u002FCI まで。lane:fast \u002F lane:gate は PR ready で止めてよい\n- **単一ゲート**: ユーザーの判断タイミングは 1 回だけ。mini-confirmation を挟むとラバースタンプ化して意味を失う\n- **事前に全て描く**: Gate 前に全 draft を揃える。Post-Gate は承認済み計画を実行し、新しい証拠で前提が崩れた場合は影響する操作を止めて報告する\n- **main 反映が完了条件**: release tag \u002F GitHub Release は default branch 反映後にだけ作る。branch-only release は未完了として扱う\n- **失敗は transparent**: 途中で失敗したら自動ロールバックは試みず、ユーザーに現状を提示して判断させる\n- **プロジェクト非依存**: VERSION file 形式、mirror、residue check など特定環境の前提を持たない。本体 harness 固有の処理は `harness-release-internal` に分離\n","# Harness Release (汎用)\n\nKeep a Changelog + GitHub を使う**あらゆるプロジェクト向け**の汎用リリース自動化スキル。\n\n**設計原則**: 単一確認ゲート。ユーザーは 1 回だけ全体計画を見て承認する。承認後はファイル書き換え → commit → branch push → PR 作成\u002F更新 → default branch へ merge → default branch 上で tag → GitHub Release までを中断なく実行する。\n\n**Release complete の定義**: release は「tag と GitHub Release を作った」だけでは完了ではない。対象 work と release bump が default branch（通常 `main`）に merge 済みで、release tag が default branch 到達可能 commit を指し、GitHub Release がその tag を公開している状態を完了とする。\n\n## PR ready vs release ready\n\nHarness V2 では PR closeout と release closeout を混同しない。\n\n| Gate | 意味 | 必須条件 | 停止 lane |\n|------|------|----------|-----------|\n| **PR ready** | ブランチが review 可能で merge 判断できる | `harness-review` `APPROVE`、focused tests PASS、evidence pack 完備（accepted\u002Frejected findings、tests、release-preflight warnings 処理、residual risk） | `[lane:fast]` \u002F `[lane:gate]` はここで停止可 |\n| **release ready** | 公開配布 path が preflight を通過 | PR ready 条件 + version surface sync + tag + GitHub Release + CI\u002Fpublic artifact 検証 | `[lane:release]` のみ |\n\n- PR ready は `harness-review` APPROVE + evidence pack で判定する。`harness-review` から push \u002F PR \u002F merge はしない。\n- release ready は `harness-release` の Preflight \u002F Post-Gate だけが判定する。version bump \u002F tag \u002F GitHub Release は release lane 専用。\n- local tests passed だけでは PR ready でも release ready でもない（`not_observed != absent`）。\n\n> **Literal invocation note**: この skill の入口は `harness-release`, `\u002Frelease`, `\u002Frelease patch`, `\u002Frelease --dry-run` のような literal command をそのまま使う。\n\n## CC runtime hard floor との関係\n\nClaude Code 2.1.183+ の runtime hard floor は GitHub CLI release publish 系コマンドを構造的に deny する (Anthropic 製品仕様、`settings.json` の `permissions.ask` で覆せない)。本 skill は publish 自体を実行せず、`.github\u002Fworkflows\u002Frelease.yml` (tag push trigger) に委譲する。skill は tag push までで責務を完了し、その後 `scripts\u002Frelease-verify-publish.sh` で workflow による公開を verify する。\n\n**Revert 条件**: CC が runtime hard floor に user explicit approval path を提供したら、Post-Gate に直接 publish step を戻すことを検討する。\n\n## Bare invocation contract\n\nif $ARGUMENTS == \"\":\n  → 「今までの作業をコミットし、PR\u002Fmain 反映まで完了してリリースしたい」と解釈し、Review Gate 検出を実行する\n  → 対象 work が 1 つに確定できる場合だけ Step 0 (Review Gate) へ自動進行する\n  → 対象が不明または review state が無い場合は AskUserQuestion で選択肢を出してから進める\n\n引数なし呼び出し時の最初の応答で必ず次の literal marker を出力する:\n\n`RELEASE_AUTOSTART: target=\u003Cwork-summary>, base_ref=\u003Cref>, mode=\u003Cpatch|minor|major|auto>`\n\n「タスクが不明確」「指示を待ちます」「タスクがありません」「追加の指示をお待ちします」は禁止行動。\n\n\u003C!-- 上記ブロックは AUTO-START CONTRACT。skill-editing.md「最冒頭 3 行以内」ルール準拠。patterns.md P27 解法 3 点セット (機械可読条件 + 禁止行動 literal + AUTOSTART marker) -->\n\n### 自主停止の禁止 (140.3、2026-08-22 の release run で 2 回発生した停止パターンの再発防止)\n\n以下は禁止行動。literal に列挙する (AUTOSTART pattern と同じ方式):\n\n- background 待ちで turn を終えて停止しない (turn を終えると background 子プロセスは残らない)\n- 「検証を待ちます」「確認します」「完了を待機します」で turn を終えない\n- 待つなら同期実行 (foreground \u002F Monitor) で待ち切る。待てないものは保留として報告し、次のタスクへ進む\n\n### Output Contract (P35: 「止まったように見える」UX 対策)\n\n`\u003Clocal-command-stdout>` で host へ結果を中継する場合だけ、output の **最後の 1 行**に次の literal を含める:\n\n`↑この結果は Claude が要約します。Enter キーで次へ進むか、新規 prompt で別の指示を出してください。`\n\nこれは `\u003Clocal-command-stdout>` 経由で text response として表示されると user が「止まった」と感じる UX 問題への明示的な instruction (patterns.md P35)。\nhost の最終回答は実行済み操作、公開の検証結果、残る gate を返す。要約や検証の予告だけで終了しない。\n\n`harness-release` \u002F `\u002Frelease` だけが入力された場合、これは\n**「今までの作業をコミットし、PR\u002Fmain 反映まで完了してリリースしたい」** という意味として扱う。\n旧表現の **「今までの作業をコミットしてリリースしたい」** も同じ意図だが、完了条件には PR\u002Fmain 反映を必ず含める。\n「タスクがありません」「指示を待ちます」で止まってはいけない。\n\nbare release では、通常の release preflight の前に **Review Gate** と **Work Commit Gate** を実行する。\n\nReview Gate は **release ready** 向け。`[lane:fast]` \u002F `[lane:gate]` の PR ready だけが必要な work には、ユーザーが release を明示しない限り `harness-release` を起動しない。\n\n1. `git status --porcelain` と `git log @{upstream}..HEAD` \u002F `main..HEAD` を確認し、「今までの作業」の対象を特定する\n2. `.claude\u002Fstate\u002Freview-result.json` と `.claude\u002Fstate\u002Freview-approved.json` を確認し、対象 work に `APPROVE` 済み review と evidence pack があるか確認する\n3. APPROVE 済み review が無い場合は `AskUserQuestion` で確認する\n4. ユーザーが「レビューから開始」を選んだら、`harness-review` を起動し、`APPROVE` になるまで release へ進まない\n5. `harness-review` が `REQUEST_CHANGES` を返した場合は release を保留し、`harness-work` で修正してから `harness-review` を再実行する。これを `APPROVE` までループする\n6. `harness-review` が `APPROVE` を返した後、working tree の作業 commit を作る\n7. working tree clean になってから通常の release preflight \u002F confirmation gate \u002F PR merge \u002F tag \u002F GitHub Release へ進む\n\n### Review Gate AskUserQuestion\n\n`harness-release` 実行時に review approval が確認できない場合は、推測で release しない。\n次の Ask を出す。\n\n```text\nquestion: \"harness-release は今までの作業をコミットしてリリースしますが、この作業の APPROVE review が見つかりません。どう進めますか？\"\noptions:\n  - label: \"レビューから開始 (Recommended)\"\n    description: \"harness-review を実行し、APPROVE になった場合だけ commit\u002Frelease へ進みます。\"\n  - label: \"release dry-run\"\n    description: \"ファイルを書き換えず、release 計画と不足 gate だけ確認します。\"\n  - label: \"中止\"\n    description: \"review も release も行わず止めます。\"\n```\n\nユーザーが「レビューから開始」を選んだ場合は、同じセッション内で `harness-review` から始める。\n`harness-review` の対象決定は `harness-review` 側の bare review contract に従う。\nreview が `APPROVE` なら、そのまま `harness-release` の Work Commit Gate へ戻る。\nreview が `REQUEST_CHANGES` なら release は保留し、`harness-work` で修正してから `harness-review` を再実行する。\nこの修正後再レビュー loop は `APPROVE` まで継続する。\n\nユーザーに戻してよいのは次の場合だけ。\n\n1. 修正に仕様正本 \u002F Plans.md \u002F API \u002F permission \u002F migration \u002F billing などの意思決定が必要で、`AskUserQuestion` が必要\n2. 修正方針が複数あり、どれを採るかでユーザー価値や互換性が変わる\n3. ユーザーが Ask で `release dry-run` または `中止` を選んだ\n\n`REQUEST_CHANGES` 単体を最終停止理由にしてはいけない。\n\n### Work Commit Gate\n\nbare release で working tree に未コミット変更がある場合、release version bump commit とは別に、\nreview 済み work commit を先に作る。\n\n```bash\ngit status --short\ngit diff --stat\ngit add \u003Creviewed files>\ngit commit -m \"\u003Ctype>: \u003Csummary>\"\n```\n\ncommit message は review summary \u002F Plans.md task \u002F branch name から短く生成する。\n表現だけが未決なら既存の commit 規約に沿って生成する。review 済みの対象そのものが曖昧な場合だけ、その対象を確認する。\nwork commit 作成後に `.claude\u002Fstate\u002Freview-result.json` の `commit_hash` を確認または更新し、\nrelease preflight へ進む。\n\n通常の release preflight に入った後は、これまで通り working tree dirty を fail とする。\ndirty tree のまま version bump \u002F tag \u002F GitHub Release に進まない。\n\n## Quick Reference\n\n```bash\n\u002Frelease              # 今までの作業を review gate → commit → PR\u002Fmain merge → release する\n\u002Frelease patch        # bump を patch に明示指定\n\u002Frelease minor        # bump を minor に明示指定\n\u002Frelease major        # bump を major に明示指定\n\u002Frelease --dry-run    # 計画の表示のみ、実行しない\n```\n\n## 前提条件\n\nこのスキルが動くプロジェクトは以下を満たす必要があります:\n\n1. `CHANGELOG.md` が [Keep a Changelog](https:\u002F\u002Fkeepachangelog.com\u002F) 形式\n2. `[Unreleased]` セクションが存在する\n3. 以下のいずれかの version file を持つ:\n   - `VERSION` (単独ファイル)\n   - `package.json` (npm)\n   - `pyproject.toml` (Python, `[project]` または `[tool.poetry]`)\n   - `Cargo.toml` (Rust, `[package]`)\n4. `gh` CLI がインストール済みで、認証済み\n5. git リモート `origin` が GitHub を指す\n6. Claude Code plugin project の場合は、`claude` CLI が `plugin validate` をサポートしている\n\nこれらが満たされない場合、Preflight で detect して abort します。\n\n`prUrlTemplate` による multi-host review URL は将来候補として認識するが、\nこのスキルの release automation は今も `gh` CLI と GitHub remote を primary path とする。\nowner \u002F branch \u002F release asset \u002F CI metadata の自動取得は host ごとの差が大きいため、Phase 56.2.3 では docs-only に留める。\n\n## 単一ゲートフロー\n\nBare release（0. Review Gate → 0.5 Work Commit Gate）→\nPre-Gate（1. Preflight → 2. Version file 検出 → 3. バージョン読み取り → 4. plugin version sync preflight → 5. bump 推定 → 6. 新バージョン算出 → 7. CHANGELOG ドラフト → 8. CHANGELOG release body preview）→\n**単一確認ゲート**（下記「Confirmation Gate」参照、`yes` \u002F `\u003C修正指示>` \u002F `cancel` の 3 択）→\nPost-Gate（9. Version file 書き換え → 10. CHANGELOG 昇格 → 11. commit → 12. branch push → 13. PR 作成\u002F更新 → 14. default branch merge → 15. 到達可能性確認 → 16. semver tag → 17. tag push → 18. workflow publish verify → 19. 完了報告）\nの 3 段階で進む。各段の詳細は「Pre-Gate 詳細」「Confirmation Gate」「Post-Gate 詳細」を参照。\n\n## Pre-Gate 詳細\n\n### 1. Preflight\n\nrelease ready gate: PR ready 条件に加え、version \u002F tag \u002F GitHub Release \u002F CI artifact path を確認する。\n\n```bash\n# 必須ツール\ncommand -v gh >\u002Fdev\u002Fnull || { echo \"gh CLI がありません\"; exit 1; }\ncommand -v python3 >\u002Fdev\u002Fnull || { echo \"python3 が必要です\"; exit 1; }\n\n# working tree\nif [ -n \"$(git status --porcelain)\" ]; then\n  echo \"working tree に未コミット変更があります\"; exit 1;\nfi\n\n# CHANGELOG\n[ -f CHANGELOG.md ] || { echo \"CHANGELOG.md がありません\"; exit 1; }\ngrep -q \"^## \\[Unreleased\\]\" CHANGELOG.md || { echo \"[Unreleased] セクションがありません\"; exit 1; }\n\n# plugin\u002Fmirror projects\nscripts\u002Frelease-preflight.sh\n```\n\nこの working tree clean check は通常 release preflight の gate である。\nbare release で「今までの作業」を commit したい場合は、この check の前に Review Gate と Work Commit Gate を完了させる。\n未レビューの dirty tree をこの check だけで abort して終わらせてはいけない。\n\n`scripts\u002Frelease-preflight.sh` は tag 作成前に `opencode\u002F`, `skills-codex\u002F`, `codex\u002F.codex\u002Fskills\u002F` の mirror drift も検出する。`node scripts\u002Fbuild-opencode.js` が差分を生成した場合は release を止め、その差分を commit してから tag に進む。\n\nrelease preflight は host workflow smoke を `REQUIRED=1`（fail-closed）で全 dist host に対して実行する。1 host でも FAIL なら release を止める。これは multi-host bar H7（release-preflight consumes host gates fail-closed）の充足配線である。`scripts\u002Frelease-preflight-host-smoke.sh` 参照。fail-closed の正本は operator マシンの preflight であり、GitHub runner（`GITHUB_ACTIONS=true`）では CLI 未 provision の host を明示 SKIP 行つきで飛ばす（tag-triggered workflow の再実行が全 release を塞がないため。v5.3.0 run 29679591686 の regression 対応）。\n\n### 2. Version File 自動検出\n\n`VERSION` → `package.json` → `pyproject.toml`（`[project]` \u002F `[tool.poetry]`）→ `Cargo.toml` の優先順で探索し、最初に見つかったものを正本とする。\n検出スニペット・読み取りロジックの詳細: [version-files.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fversion-files.md)\n\n### 3. Claude Plugin Version Sync Preflight\n\n`.claude-plugin\u002Fplugin.json` が存在する project では、semver tag を切る前に plugin manifest の validation と全 version surface の同期を確認する。\n\n> **plugin tag (`{plugin-name}--v{version}`) は 2026-08-17 に廃止**。`marketplace.json` の `source` が相対パス (`\".\u002F\"`) で install は tag を参照しないため、実効性が無いまま v5.6.0 以降 3 リリース連続で欠番になっていた。GitHub Release 用 semver tag `vX.Y.Z` に一本化する (decisions.md D69)。\n\nPre-Gate ではファイルを書き換えず、以下を確認する。\nversion sync は `grep` \u002F `sed` で拾わず、JSON は structured parser で読む:\n\n```bash\ncommand -v claude >\u002Fdev\u002Fnull || { echo \"claude CLI がありません\"; exit 1; }\nclaude plugin validate .claude-plugin\u002Fplugin.json\n\nHARNESS_PLUGIN_ROOT=\"${CLAUDE_PLUGIN_ROOT:-.}\"\npython3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root .\n```\n\n`${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py` は、存在する release surface をすべて読み取り、canonical を `VERSION > package.json > .claude-plugin\u002Fplugin.json > .codex-plugin\u002Fplugin.json` の順で決める。\nそのうえで、以下の不一致・欠落が 1 つでもあれば tag \u002F release に進まない:\n\n- `VERSION`\n- `package.json` の `.version`\n- `.claude-plugin\u002Fplugin.json` の `.version`\n- `.codex-plugin\u002Fplugin.json` の `.version`\n- `.claude-plugin\u002Fmarketplace.json` の `.metadata.version`\n- `.claude-plugin\u002Fmarketplace.json` の `.plugins[].version`（配列内の各 plugin entry）\n\n不一致時は、どの surface が canonical と違うか、またはどの field が missing \u002F invalid かを表示する。\n機械処理や CI で読む場合は `--json` を使う:\n\n```bash\npython3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root . --json\n```\n\nこの check は 3 つの事故を防ぐためにある:\n\n- `VERSION` と `.claude-plugin\u002Fplugin.json` の version がずれたまま tag を切る事故\n- `package.json` \u002F marketplace entry の version が古いまま release workflow に進む事故\n- plugin manifest \u002F marketplace entry の validation を通さず、あとで plugin install \u002F update 側で詰まる事故\n\nこの check の結果 (canonical version と各 surface の一致) を Confirmation Gate の plan に含める。\n\n### 4. Bump 自動推定\n\n`[Unreleased]` 直下の見出し（`### Breaking Changes`\u002F`### Removed` → major、`### Added` → minor、`### Fixed`\u002F`### Changed`\u002F`### Security` のみ → patch、空セクション → error）を解析して bump level を決定する。\nユーザーが `\u002Frelease patch|minor|major` で明示指定した場合はそちらを優先。\n詳細: [bump-detection.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fbump-detection.md)\n\n### 5. CHANGELOG ドラフト作成 (メモリ上)\n\n`[Unreleased]` の内容を切り出し、`[\u003Cnew>] - YYYY-MM-DD` セクションと compare link を組み立てる（まだ書き込まない）。\n詳細: [release-notes.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Frelease-notes.md#changelog-ドラフト作成メモリ上pre-gate-ステップ-7)\n\n### 6. CHANGELOG release body preview (メモリ上)\n\ntag-triggered workflow が公開する本文は、昇格後の `## [\u003Cnew>]` セクション本文そのもの。\n別の英訳・要約・フッターを生成せず、workflow と同じ抽出境界の本文をそのまま preview する。\n抽出方法・検証チェックの詳細: [release-notes.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Frelease-notes.md)\n\n## Confirmation Gate\n\nすべてのドラフトが揃ったら、ユーザーに 1 回だけ提示:\n\n```\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nRelease Plan: v\u003Cold> → v\u003Cnew> (\u003Cbump>)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n Version file: \u003Cdetected file>\n Bump reason:  \u003Cwhy this level was chosen>\n\n CHANGELOG changes:\n   [Unreleased] に \u003CN> 項目の変更を検出\n   [\u003Cnew>] - YYYY-MM-DD として確定\n   Compare link を追加\n\n CHANGELOG release body preview (workflow が公開する本文):\n   \u003Cworkflow が公開する本文の全行>\n\n Files to modify:\n   - \u003Cversion file>\n   - CHANGELOG.md\n\n Final actions:\n   - git commit -m \"chore: release v\u003Cnew>\"\n   - git push origin \u003Crelease-branch>\n   - gh pr create\u002Fupdate + gh pr merge into \u003Cdefault-branch>\n   - git fetch origin \u003Cdefault-branch> && git checkout \u003Cdefault-branch>\n   - git tag -a v\u003Cnew>                                        # GitHub Release 用 semver tag。default branch 上で作成\n   - git push origin \u003Cdefault-branch> --tags\n   - (tag push 後は GitHub Actions release workflow が自動で release 公開)\n\nProceed? [yes \u002F cancel \u002F \u003C修正指示>]\n```\n\n## Post-Gate 詳細\n\n承認後は中断なしで実行。失敗時は以下の方針:\n\n| 失敗箇所 | 復旧 |\n|---------|------|\n| ファイル書き換え失敗 | そこで abort、ローカルは dirty なまま人間が判断 |\n| commit 失敗 | hook 拒否等。ユーザーに原因を提示して修正を促す |\n| PR 作成\u002Fmerge 失敗 | release を未完了として停止。tag \u002F GitHub Release には進まない |\n| plugin version sync 失敗 | `VERSION` \u002F `.claude-plugin\u002Fplugin.json` \u002F marketplace entry の不一致を修正し、tag 作成には進まない |\n| push 失敗 | リモート側の問題。ローカル commit\u002Ftag は残す |\n\n### PR \u002F Main Merge Gate、semver tag、Verify Publish\n\nPost-Gate の release commit 後、tag を作る前に GitHub PR を default branch へ merge する（`gh pr create` → `gh pr merge --merge` → default branch fetch\u002Fcheckout で release commit の到達可能性を確認）。release branch 上だけに存在する commit を指す tag で GitHub Release を作ってはいけない。\n`.claude-plugin\u002Fplugin.json` がある project では、merge 後に default branch 上で version sync を再確認してから semver tag `vX.Y.Z` を作る (plugin tag は 2026-08-17 廃止、D69)。\ntag push 後は `bash scripts\u002Frelease-verify-publish.sh` で `.github\u002Fworkflows\u002Frelease.yml` の公開結果を verify する（5 秒間隔 × 60 回 polling、exit 0=PASS \u002F 2=WARN(timeout) \u002F 3=ERROR）。\nコマンド全文・失敗時の判断基準は [post-gate-detail.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fpost-gate-detail.md) を参照。\n\n## `--dry-run` モード\n\nPre-Gate 全てを実行し、Confirmation Gate までの内容を表示するが、**gate で止まり Post-Gate に進まない**。\n\nClaude plugin project の場合、dry-run でも `python3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root .` を実行し、canonical version と各 surface の一致を表示する。ここで `VERSION` \u002F `package.json` \u002F `.claude-plugin\u002Fplugin.json` \u002F `.codex-plugin\u002Fplugin.json` \u002F `.claude-plugin\u002Fmarketplace.json` の version surface が不一致または欠落していれば、dry-run の時点で止める。\n\n## 環境変数\n\nプロジェクトごとの調整に使用:\n\n| 変数 | 説明 |\n|------|------|\n| `HARNESS_RELEASE_PROJECT_ROOT` | リポジトリルート (デフォルト: `$(pwd)`) |\n| `HARNESS_RELEASE_BRANCH` | push 対象ブランチ (デフォルト: 現在のブランチ) |\n| `HARNESS_RELEASE_DEFAULT_BRANCH` | PR merge 先 default branch (デフォルト: `main`) |\n| `HARNESS_RELEASE_HEALTHCHECK_CMD` | Preflight で追加実行するコマンド |\n| `HARNESS_RELEASE_SKIP_GH` | `1` で GitHub publication verification をスキップ |\n\n## CHANGELOG 書き方ルール\n\n`[Unreleased]` セクションは KaCL 標準サブセクション（`### Added`=minor \u002F `### Changed`・`### Fixed`・`### Security`=patch \u002F `### Deprecated`=minor \u002F `### Removed`・`### Breaking Changes`=major）のいずれかを持つ必要がある。\nこのスキルはこれらの見出しを機械的に解析するため、表記揺れ（`### Fix` \u002F `### Bug Fixes` 等）は認識できない。\n\nCHANGELOG release body の preview 契約・CHANGELOG の書き方・merge 方式（squash 不採用）の詳細は\n[github-release.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fgithub-release.md) を参照。\nSemVer 判定基準・バッチリリース方針・Release Train Proposal の詳細は\n[versioning.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fversioning.md) を参照。\n\n## 出荷前の受け入れ判断（非エンジニア向け）\n\nリリース確定の前に `harness-accept` を提案する。各合格条件が満たされたかと ship\u002Fwait\u002Freject の\n推奨を 1 枚の HTML にまとめた「受け入れ判断」画面で、発注者が専門知識なしで出荷可否を判断できる。\n\n## 関連スキル\n\n- `harness-release-internal` - 本体 claude-code-harness のリリース時に追加で走らせる harness 固有 preflight\u002Ffinalization（配布対象外）\n- `harness-plan` - Plans.md 管理\n- `harness-review` - リリース前のコードレビュー\n- `harness-accept` - 受け入れ判断 HTML（非エンジニア向け、リリース前に提案）\n\n## 設計思想\n\n- **PR ready \u002F release ready 分離**: PR ready は review + evidence pack。release ready は version\u002Ftag\u002FGitHub Release\u002FCI まで。lane:fast \u002F lane:gate は PR ready で止めてよい\n- **単一ゲート**: ユーザーの判断タイミングは 1 回だけ。mini-confirmation を挟むとラバースタンプ化して意味を失う\n- **事前に全て描く**: Gate 前に全 draft を揃える。Post-Gate は承認済み計画を実行し、新しい証拠で前提が崩れた場合は影響する操作を止めて報告する\n- **main 反映が完了条件**: release tag \u002F GitHub Release は default branch 反映後にだけ作る。branch-only release は未完了として扱う\n- **失敗は transparent**: 途中で失敗したら自動ロールバックは試みず、ユーザーに現状を提示して判断させる\n- **プロジェクト非依存**: VERSION file 形式、mirror、residue check など特定環境の前提を持たない。本体 harness 固有の処理は `harness-release-internal` に分離\n",{"name":5,"description":7},"c2304c325d4432f51d632e0586d886767b0f41ea","opencode\u002Fskills\u002Fharness-release",306,"https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness","https:\u002F\u002Fgithub.com\u002FChachamaru127","https:\u002F\u002Fcanai.jp\u002F","Going all-in on the AI business from April 2025\r\nOSS release: 3k Stars\r\nAI adoption starting with \"I want\"\r\nAX Support | Tokenomics | AISDR |","2026-11-11 17:18:34",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add Chachamaru127\u002Fclaude-code-harness --skill harness-release",{"tool":63,"command":64},"bunx","bunx skills add Chachamaru127\u002Fclaude-code-harness --skill harness-release",{"tool":66,"command":67},"pnpm","pnpm dlx skills add Chachamaru127\u002Fclaude-code-harness --skill harness-release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002FSKILL.md",true,[71,77,81,85,89,93,97,101,105],{"path":72,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Fbump-detection.md","REFERENCE","参考文档",3662,"https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002Freferences\u002Fbump-detection.md",{"path":78,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Fcommunication-templates.md",25741,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-production-scheduling\u002Freferences\u002Fcommunication-templates.md",{"path":82,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002Fdecision-frameworks.md",6662,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-production-scheduling\u002Freferences\u002Fdecision-frameworks.md",{"path":86,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":87,"sourceHtmlUrl":88},"references\u002Fedge-cases.md",7196,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fantigravity-production-scheduling\u002Freferences\u002Fedge-cases.md",{"path":90,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":91,"sourceHtmlUrl":92},"references\u002Fgithub-release.md",6620,"https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002Freferences\u002Fgithub-release.md",{"path":94,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":95,"sourceHtmlUrl":96},"references\u002Fpost-gate-detail.md",3204,"https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002Freferences\u002Fpost-gate-detail.md",{"path":98,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":99,"sourceHtmlUrl":100},"references\u002Frelease-notes.md",2207,"https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002Freferences\u002Frelease-notes.md",{"path":102,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":103,"sourceHtmlUrl":104},"references\u002Fversion-files.md",3903,"https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002Freferences\u002Fversion-files.md",{"path":106,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":107,"sourceHtmlUrl":108},"references\u002Fversioning.md",5983,"https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fopencode\u002Fskills\u002Fharness-release\u002Freferences\u002Fversioning.md",[110,128,136,155,182,206],{"skillNo":111,"name":112,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":120,"publishedAt":44},"01M6C4VZCJB9EN3KZXGNARAF6P","escape-skill","https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fzz-review-escape\u002FSKILL.md",[115],{"categoryNo":116,"categoryName":117,"taxonomyType":118,"taxonomyTypeDesc":119},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[121,122,123,124,125,126,127],"escape skill","escape","Tools","false","true","path","quoted",{"skillNo":129,"name":130,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":131,"categories":132,"keywords":133,"publishedAt":44},"01M6C4VYAJW332S5R2MM3RNE0G","zz-review-empty","https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fzz-review-empty\u002FSKILL.md",[],[34,134,135,124,125],"zz review empty","empty",{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":140,"categories":141,"keywords":143,"publishedAt":44},"01M6C4VWW4GNAZ2680GY04S3EW","session-send","This skill should be used when the user asks to notify other session, requests a session handoff, says tell other agent, or needs a cross-session message.","https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fskills\u002Fsession-send\u002FSKILL.md",[142],{"categoryNo":116,"categoryName":117,"taxonomyType":118,"taxonomyTypeDesc":119},[144,145,146,147,148,149,150,151,152,153,154],"session","session send","send","handoff","session handoff","Bash","user","message","notify","requests","when",{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":159,"categories":160,"keywords":162,"publishedAt":44},"01M6C4VSMYH6XQGR087HQ9Y7HT","memory","Manage SSOT, memory, and cross-tool memory search. Guardian of decisions.md and patterns.md. Use when user mentions memory, SSOT, decisions.md, patterns.md, merging, migration, SSOT promotion, sync memory, save learnings, memory search, harness-mem, past decisions, or record this. Do NOT load for: implementation work, reviews, ad-hoc notes, or in-session logging.","https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fskills\u002Fmemory\u002FSKILL.md",[161],{"categoryNo":116,"categoryName":117,"taxonomyType":118,"taxonomyTypeDesc":119},[157,163,164,165,20,166,167,168,149,169,170,171,172,173,174,175,150,144,176,177,178,29,179,25,180,125,181,24,154],"MCP","sync","notes","search","memory search","guardian","migrate","tool","work","decisions","read","write","edit","use","migration","manage","learnings","reviews","load",{"skillNo":183,"name":184,"nameZh":6,"description":185,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":186,"categories":187,"keywords":188,"publishedAt":44},"01M6C4VQ3507BV9XRX4BDSES6J","maintenance","File cleanup and archiving. Tidies up bloated Plans.md, session-log.md, old logs, and state files. Trigger: \u002Fmaintenance, cleanup, archive, organize, split session-log. Do NOT load for: implementation, review, release, new feature development.","https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fskills\u002Fmaintenance\u002FSKILL.md",[],[184,34,189,190,191,19,192,193,194,149,195,196,173,174,175,197,144,198,199,200,29,201,202,26,203,204,125,181,24,205],"development","cleanup","run","state","file","logs","archive","grep","new feature","up","log","files","feature","plans","整理","split","new",{"skillNo":207,"name":208,"nameZh":6,"description":209,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":210,"categories":211,"keywords":224,"publishedAt":44},"01M6C4VK473YJ872RNMBYK7P4R","japanese-writing-drafter","Detect when the operator corrects the agent's Japanese phrasing mid-conversation (rewrites a sentence, calls out a style problem, says 'this wording is bad, say it like X instead') and draft a pending writing-rule proposal into ~\u002F.claude\u002Fwriting-lint\u002Fproposals.jsonl for later human review. This skill is the ONLY writer of proposals.jsonl — it never edits rules.jsonl and never sets status to anything but pending. Promotion to rules.jsonl only happens via the human-run scripts\u002Fwriting-rule-approve.sh. Use when user mentions writing-rule proposal, 表現を直して, 文体を直して, その言い方はNG, writing lint 提案, 指摘をルール化して. Do NOT load for: approving or rejecting proposals (use scripts\u002Fwriting-rule-approve.sh), listing pending proposals (use scripts\u002Fwriting-rule-list.sh), or scanning text against the existing dictionary (the writinglint engine \u002F PostToolUse hook does that).","https:\u002F\u002Fgithub.com\u002FChachamaru127\u002Fclaude-code-harness\u002Fblob\u002Fmain\u002Fskills\u002Fjapanese-writing-drafter\u002FSKILL.md",[212,215,218,219],{"categoryNo":213,"categoryName":214,"taxonomyType":118,"taxonomyTypeDesc":119},"01JBSEEDCAT000000000000007","代码审查",{"categoryNo":216,"categoryName":217,"taxonomyType":118,"taxonomyTypeDesc":119},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":116,"categoryName":117,"taxonomyType":118,"taxonomyTypeDesc":119},{"categoryNo":220,"categoryName":221,"taxonomyType":222,"taxonomyTypeDesc":223},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[225,226,227,34,228,191,229,230,149,231,232,233,234,173,235,236,176,237,238,239,240,241,242,243,244,245,246,247,248,249,154,250],"writing","japanese writing drafter","japanese","status","lint","operator","提案","text","engine","Rules","list","proposals","never","only","scanning","say","human review","later","conversation","writer","human","scripts","problem","proposal","jsonl","listing"]