[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79BF1FSJ529A71QDPC7RJF9":3,"skill-same:01M79BF1FSJ529A71QDPC7RJF9":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M79BF1FSJ529A71QDPC7RJF9","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.","Timothy191\u002Farch-systems-portal","Timothy191","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219252205?v=4","01M79B3963G748F05KS7AH3NJR","01M79B396N88AYYNHK5G2DNP2S",0,"MIT","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fopencode\u002Fskills\u002Fharness-release\u002FSKILL.md",[],[],"2026-11-15 14:19:17",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> **Literal invocation note**: この skill の入口は `harness-release`, `\u002Frelease`, `\u002Frelease patch`, `\u002Frelease --dry-run` のような literal command をそのまま使う。\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### Output Contract (P35: 「止まったように見える」UX 対策)\n\nskill 結論時の output の **最後の 1 行**は必ず次の literal を含める:\n\n`↑この結果は Claude が要約します。Enter キーで次へ進むか、新規 prompt で別の指示を出してください。`\n\nこれは `\u003Clocal-command-stdout>` 経由で text response として表示されると user が「止まった」と感じる UX 問題への明示的な instruction (patterns.md P35)。\n\n`harness-release` \u002F `\u002Frelease` だけが入力された場合、これは\n**「今までの作業をコミットし、PR\u002Fmain 反映まで完了してリリースしたい」** という意味として扱う。\n旧表現の **「今までの作業をコミットしてリリースしたい」** も同じ意図だが、完了条件には PR\u002Fmain 反映を必ず含める。\n「タスクがありません」「指示を待ちます」で止まってはいけない。\n\nbare release では、通常の release preflight の前に **Review Gate** と **Work Commit Gate** を実行する。\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 があるか確認する\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判断できない場合は `AskUserQuestion` で 2〜3 個の commit message 候補を出す。\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 tag` をサポートしている\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\n```\n[Bare release only: 作業 review\u002Fcommit 前段]\n  ↓\n  0. Review Gate (未レビューなら AskUserQuestion → harness-review)\n  0.5 Work Commit Gate (review APPROVE 済み work を release bump と分けて commit)\n  ↓\n[Pre-Gate: 情報収集のみ、ファイル未変更]\n  ↓\n  1. Preflight (working tree clean \u002F CHANGELOG \u002F gh 等の確認)\n  2. Version file 自動検出\n  3. 現在バージョンの読み取り\n  4. Claude plugin tag preflight (plugin project の場合のみ)\n  5. [Unreleased] 内容の解析 → bump level 推定\n  6. 新バージョン算出\n  7. CHANGELOG 差分ドラフト作成 (メモリ上)\n  8. GitHub Release notes ドラフト作成 (メモリ上)\n\n★━━━━━━ 単一確認ゲート ━━━━━━★\n  ユーザーに全計画を 1 回だけ提示:\n    - 検出された version file\n    - 現バージョン → 新バージョン\n    - bump 判定理由 (\"[Unreleased] に ### Added があるため minor\" 等)\n    - CHANGELOG 変更プレビュー\n    - GitHub Release notes ドラフト\n    - コミット対象ファイル一覧\n    - 最終アクション (branch push + PR merge + tag + release publish)\n\n  ユーザー応答:\n    \"yes\"        → Post-Gate へ進む\n    \"\u003C修正指示>\"  → 指示に応じて draft を再生成、再確認\n    \"cancel\u002Fno\"  → 何もせず終了\n★━━━━━━━━━━━━━━━━━━━━━━━★\n  ↓\n[Post-Gate: 承認後、中断なし]\n\n  9. Version file 書き換え\n  10. CHANGELOG.md 書き換え ([Unreleased] → [X.Y.Z] 昇格 + compare link)\n  11. git add + commit\n  12. release branch push\n  13. PR 作成\u002F更新\n  14. default branch へ merge\n  15. default branch を fetch\u002Fcheckout し、release commit が到達可能であることを確認\n  16. Claude plugin tag validation + tag (plugin project の場合のみ)\n  17. GitHub Release 用 semver tag (必要な project のみ)\n  18. git push origin \u003Cdefault-branch> --tags\n  19. gh release create vX.Y.Z\n  20. 完了報告\n```\n\n## Pre-Gate 詳細\n\n### 1. Preflight\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\n### 2. Version File 自動検出\n\n以下を優先順で探索。最初に見つかったものを正本とする:\n\n```python\n# Python snippet to run inline\nimport os, json, re\nimport tomllib  # Python 3.11+\n\ndef detect_version_file():\n    if os.path.exists(\"VERSION\"):\n        with open(\"VERSION\") as f:\n            return (\"VERSION\", f.read().strip(), None)\n    if os.path.exists(\"package.json\"):\n        with open(\"package.json\") as f:\n            data = json.load(f)\n        return (\"package.json\", data[\"version\"], None)\n    if os.path.exists(\"pyproject.toml\"):\n        with open(\"pyproject.toml\", \"rb\") as f:\n            data = tomllib.load(f)\n        if \"project\" in data:\n            return (\"pyproject.toml\", data[\"project\"][\"version\"], \"[project]\")\n        if \"tool\" in data and \"poetry\" in data[\"tool\"]:\n            return (\"pyproject.toml\", data[\"tool\"][\"poetry\"][\"version\"], \"[tool.poetry]\")\n    if os.path.exists(\"Cargo.toml\"):\n        with open(\"Cargo.toml\", \"rb\") as f:\n            data = tomllib.load(f)\n        return (\"Cargo.toml\", data[\"package\"][\"version\"], \"[package]\")\n    raise RuntimeError(\"No supported version file found\")\n```\n\n詳細: [version-files.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fversion-files.md)\n\n### 3. Claude Plugin Tag Preflight\n\n`.claude-plugin\u002Fplugin.json` が存在する project では、通常の GitHub Release tag とは別に Claude plugin release tag も作る。\n\nひとことで言うと、`git tag -a` を手で組み立てる前に、Claude Code 本体の plugin validation に通してから `{plugin-name}--v{version}` tag を作る。\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\nclaude plugin tag .claude-plugin --dry-run\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`--dry-run` では `claude plugin tag` が実際に作る tag 名と内部の `git tag -a` \u002F push 相当コマンドが見える。ここで見えた command を Confirmation Gate の plan に含める。\n\n### 4. Bump 自動推定\n\n`[Unreleased]` 直下の見出しを解析して bump level を決定:\n\n| [Unreleased] 内の見出し                            | 推定 bump                   |\n| -------------------------------------------------- | --------------------------- |\n| `### Breaking Changes` または `### Removed` を含む | **major**                   |\n| `### Added` を含む (Removed\u002FBreaking なし)         | **minor**                   |\n| `### Fixed` \u002F `### Changed` \u002F `### Security` のみ  | **patch**                   |\n| 空セクション                                       | **error: リリース対象なし** |\n\nユーザーが `\u002Frelease patch|minor|major` で明示指定した場合はそちらを優先。\n詳細: [bump-detection.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fbump-detection.md)\n\n### 5. CHANGELOG ドラフト作成 (メモリ上)\n\n以下を計算、まだ書き込まない:\n\n1. `## [Unreleased]` の本文を切り出し\n2. `## [Unreleased]` と `## [\u003Cprevious>]` の間に `## [\u003Cnew>] - YYYY-MM-DD` を挿入した形を作成\n3. 末尾 compare link:\n   - `[Unreleased]: ...\u002Fcompare\u002Fv\u003Cprev>...HEAD` → `v\u003Cnew>...HEAD`\n   - `[\u003Cnew>]: ...\u002Fcompare\u002Fv\u003Cprev>...v\u003Cnew>` を追加\n4. repo URL は既存の `[Unreleased]: ` 行から動的抽出\n\n### 6. Release Notes ドラフト作成 (メモリ上)\n\n`## [\u003Cnew>]` セクションの内容を元に、GitHub Release 用のマークダウンを生成:\n\n```markdown\n## What's Changed\n\n**\u003Cリリーステーマ(1行)>**\n\n### Before \u002F After\n\n\u003Cテーブル>\n\n### Added \u002F Changed \u002F Fixed \u002F Removed\n\n\u003C該当セクションをコピー>\n\n---\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code)\n```\n\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 GitHub Release notes preview:\n   \u003C最初の 10 行>\n   ...\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   - claude plugin tag .claude-plugin --push --remote origin  # plugin project の場合。default branch 上で実行\n   - git tag -a v\u003Cnew>                                        # GitHub Release 用 semver tag が必要な場合。default branch 上で作成\n   - git push origin \u003Cdefault-branch> --tags\n   - gh release create v\u003Cnew>\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 tag validation 失敗 | `VERSION` \u002F `.claude-plugin\u002Fplugin.json` \u002F marketplace entry の不一致を修正し、tag 作成には進まない |\n| push 失敗                  | リモート側の問題。ローカル commit\u002Ftag は残す                                                        |\n| `gh release create` 失敗   | tag は push 済みなので、既存の release.yml セーフティネットが発火するか、手動で `gh release create` |\n\n### PR \u002F Main Merge Gate\n\nPost-Gate の release commit 後は、tag を作る前に GitHub PR を default branch へ merge する。\n\n```bash\nrelease_branch=\"$(git branch --show-current)\"\ndefault_branch=\"${HARNESS_RELEASE_DEFAULT_BRANCH:-main}\"\n\ngit push -u origin \"$release_branch\"\ngh pr create --base \"$default_branch\" --head \"$release_branch\" --title \"chore: release v\u003Cnew>\" --body \"\u003Crelease summary>\"\ngh pr merge --merge --delete-branch=false\n\ngit fetch origin \"$default_branch\" --tags\ngit checkout \"$default_branch\"\ngit pull --ff-only origin \"$default_branch\"\ngit merge-base --is-ancestor \"\u003Crelease-commit>\" \"origin\u002F$default_branch\"\n```\n\n既存 PR がある場合は新規作成せず、既存 PR の body を更新して merge する。repository policy が squash merge を要求する場合は、release commit hash ではなく release bump の内容（version files + CHANGELOG + source commits）が default branch に含まれることを確認する。\n\ntag はこの Gate 完了後、default branch の HEAD もしくは release commit 到達可能な commit に対して作る。release branch 上だけに存在する commit を指す tag で GitHub Release を作ってはいけない。\n\n### Claude plugin project の tag 作成\n\n`.claude-plugin\u002Fplugin.json` がある project では、PR\u002Fmain merge 後に default branch 上でもう一度 version sync を確認してから plugin tag を作る:\n\n```bash\nHARNESS_PLUGIN_ROOT=\"${CLAUDE_PLUGIN_ROOT:-.}\"\npython3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root .\n\nclaude plugin tag .claude-plugin --dry-run\nclaude plugin tag .claude-plugin --push --remote origin\n```\n\n`claude plugin tag` が作る tag は `{plugin-name}--v{version}` 形式。既存の GitHub Release workflow が `vX.Y.Z` tag を前提にしている project では、plugin tag とは別に `git tag -a v\u003Cnew>` を作る。plugin 配布の tag は `claude plugin tag` に任せ、GitHub Release 用 semver tag は release automation の互換 surface として扱う。\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 .` と `claude plugin tag .claude-plugin --dry-run` を実行し、実際に作られる plugin tag 名と push 対象を表示する。ここで `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 Release 作成をスキップ            |\n\n## CHANGELOG 書き方ルール\n\n`[Unreleased]` セクションは必ず以下のいずれかのサブセクションを持つ:\n\n```markdown\n## [Unreleased]\n\n### Added ← minor\n\n### Changed ← patch\n\n### Deprecated ← minor\n\n### Removed ← major\n\n### Fixed ← patch\n\n### Security ← patch\n\n### Breaking Changes ← major (Keep a Changelog 非標準だが一般的)\n```\n\nこのスキルはこれらの見出しを機械的に解析するため、見出しの表記揺れ（`### Fix` \u002F `### Bug Fixes` 等）は認識できません。KaCL 標準の見出しを使用してください。\n\n## 関連スキル\n\n- `harness-release-internal` - 本体 claude-code-harness のリリース時に追加で走らせる harness 固有 preflight\u002Ffinalization（配布対象外）\n- `harness-plan` - Plans.md 管理\n- `harness-review` - リリース前のコードレビュー\n\n## 設計思想\n\n- **単一ゲート**: ユーザーの判断タイミングは 1 回だけ。mini-confirmation を挟むとラバースタンプ化して意味を失う\n- **事前に全て描く**: Post-Gate に入ってからの「考え直し」を禁ずる。Gate 前に全 draft を揃える\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> **Literal invocation note**: この skill の入口は `harness-release`, `\u002Frelease`, `\u002Frelease patch`, `\u002Frelease --dry-run` のような literal command をそのまま使う。\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### Output Contract (P35: 「止まったように見える」UX 対策)\n\nskill 結論時の output の **最後の 1 行**は必ず次の literal を含める:\n\n`↑この結果は Claude が要約します。Enter キーで次へ進むか、新規 prompt で別の指示を出してください。`\n\nこれは `\u003Clocal-command-stdout>` 経由で text response として表示されると user が「止まった」と感じる UX 問題への明示的な instruction (patterns.md P35)。\n\n`harness-release` \u002F `\u002Frelease` だけが入力された場合、これは\n**「今までの作業をコミットし、PR\u002Fmain 反映まで完了してリリースしたい」** という意味として扱う。\n旧表現の **「今までの作業をコミットしてリリースしたい」** も同じ意図だが、完了条件には PR\u002Fmain 反映を必ず含める。\n「タスクがありません」「指示を待ちます」で止まってはいけない。\n\nbare release では、通常の release preflight の前に **Review Gate** と **Work Commit Gate** を実行する。\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 があるか確認する\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判断できない場合は `AskUserQuestion` で 2〜3 個の commit message 候補を出す。\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 tag` をサポートしている\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\n```\n[Bare release only: 作業 review\u002Fcommit 前段]\n  ↓\n  0. Review Gate (未レビューなら AskUserQuestion → harness-review)\n  0.5 Work Commit Gate (review APPROVE 済み work を release bump と分けて commit)\n  ↓\n[Pre-Gate: 情報収集のみ、ファイル未変更]\n  ↓\n  1. Preflight (working tree clean \u002F CHANGELOG \u002F gh 等の確認)\n  2. Version file 自動検出\n  3. 現在バージョンの読み取り\n  4. Claude plugin tag preflight (plugin project の場合のみ)\n  5. [Unreleased] 内容の解析 → bump level 推定\n  6. 新バージョン算出\n  7. CHANGELOG 差分ドラフト作成 (メモリ上)\n  8. GitHub Release notes ドラフト作成 (メモリ上)\n\n★━━━━━━ 単一確認ゲート ━━━━━━★\n  ユーザーに全計画を 1 回だけ提示:\n    - 検出された version file\n    - 現バージョン → 新バージョン\n    - bump 判定理由 (\"[Unreleased] に ### Added があるため minor\" 等)\n    - CHANGELOG 変更プレビュー\n    - GitHub Release notes ドラフト\n    - コミット対象ファイル一覧\n    - 最終アクション (branch push + PR merge + tag + release publish)\n\n  ユーザー応答:\n    \"yes\"        → Post-Gate へ進む\n    \"\u003C修正指示>\"  → 指示に応じて draft を再生成、再確認\n    \"cancel\u002Fno\"  → 何もせず終了\n★━━━━━━━━━━━━━━━━━━━━━━━★\n  ↓\n[Post-Gate: 承認後、中断なし]\n\n  9. Version file 書き換え\n  10. CHANGELOG.md 書き換え ([Unreleased] → [X.Y.Z] 昇格 + compare link)\n  11. git add + commit\n  12. release branch push\n  13. PR 作成\u002F更新\n  14. default branch へ merge\n  15. default branch を fetch\u002Fcheckout し、release commit が到達可能であることを確認\n  16. Claude plugin tag validation + tag (plugin project の場合のみ)\n  17. GitHub Release 用 semver tag (必要な project のみ)\n  18. git push origin \u003Cdefault-branch> --tags\n  19. gh release create vX.Y.Z\n  20. 完了報告\n```\n\n## Pre-Gate 詳細\n\n### 1. Preflight\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\n### 2. Version File 自動検出\n\n以下を優先順で探索。最初に見つかったものを正本とする:\n\n```python\n# Python snippet to run inline\nimport os, json, re\nimport tomllib  # Python 3.11+\n\ndef detect_version_file():\n    if os.path.exists(\"VERSION\"):\n        with open(\"VERSION\") as f:\n            return (\"VERSION\", f.read().strip(), None)\n    if os.path.exists(\"package.json\"):\n        with open(\"package.json\") as f:\n            data = json.load(f)\n        return (\"package.json\", data[\"version\"], None)\n    if os.path.exists(\"pyproject.toml\"):\n        with open(\"pyproject.toml\", \"rb\") as f:\n            data = tomllib.load(f)\n        if \"project\" in data:\n            return (\"pyproject.toml\", data[\"project\"][\"version\"], \"[project]\")\n        if \"tool\" in data and \"poetry\" in data[\"tool\"]:\n            return (\"pyproject.toml\", data[\"tool\"][\"poetry\"][\"version\"], \"[tool.poetry]\")\n    if os.path.exists(\"Cargo.toml\"):\n        with open(\"Cargo.toml\", \"rb\") as f:\n            data = tomllib.load(f)\n        return (\"Cargo.toml\", data[\"package\"][\"version\"], \"[package]\")\n    raise RuntimeError(\"No supported version file found\")\n```\n\n詳細: [version-files.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fversion-files.md)\n\n### 3. Claude Plugin Tag Preflight\n\n`.claude-plugin\u002Fplugin.json` が存在する project では、通常の GitHub Release tag とは別に Claude plugin release tag も作る。\n\nひとことで言うと、`git tag -a` を手で組み立てる前に、Claude Code 本体の plugin validation に通してから `{plugin-name}--v{version}` tag を作る。\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\nclaude plugin tag .claude-plugin --dry-run\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`--dry-run` では `claude plugin tag` が実際に作る tag 名と内部の `git tag -a` \u002F push 相当コマンドが見える。ここで見えた command を Confirmation Gate の plan に含める。\n\n### 4. Bump 自動推定\n\n`[Unreleased]` 直下の見出しを解析して bump level を決定:\n\n| [Unreleased] 内の見出し                            | 推定 bump                   |\n| -------------------------------------------------- | --------------------------- |\n| `### Breaking Changes` または `### Removed` を含む | **major**                   |\n| `### Added` を含む (Removed\u002FBreaking なし)         | **minor**                   |\n| `### Fixed` \u002F `### Changed` \u002F `### Security` のみ  | **patch**                   |\n| 空セクション                                       | **error: リリース対象なし** |\n\nユーザーが `\u002Frelease patch|minor|major` で明示指定した場合はそちらを優先。\n詳細: [bump-detection.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fbump-detection.md)\n\n### 5. CHANGELOG ドラフト作成 (メモリ上)\n\n以下を計算、まだ書き込まない:\n\n1. `## [Unreleased]` の本文を切り出し\n2. `## [Unreleased]` と `## [\u003Cprevious>]` の間に `## [\u003Cnew>] - YYYY-MM-DD` を挿入した形を作成\n3. 末尾 compare link:\n   - `[Unreleased]: ...\u002Fcompare\u002Fv\u003Cprev>...HEAD` → `v\u003Cnew>...HEAD`\n   - `[\u003Cnew>]: ...\u002Fcompare\u002Fv\u003Cprev>...v\u003Cnew>` を追加\n4. repo URL は既存の `[Unreleased]: ` 行から動的抽出\n\n### 6. Release Notes ドラフト作成 (メモリ上)\n\n`## [\u003Cnew>]` セクションの内容を元に、GitHub Release 用のマークダウンを生成:\n\n```markdown\n## What's Changed\n\n**\u003Cリリーステーマ(1行)>**\n\n### Before \u002F After\n\n\u003Cテーブル>\n\n### Added \u002F Changed \u002F Fixed \u002F Removed\n\n\u003C該当セクションをコピー>\n\n---\n\n🤖 Generated with [Claude Code](https:\u002F\u002Fclaude.com\u002Fclaude-code)\n```\n\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 GitHub Release notes preview:\n   \u003C最初の 10 行>\n   ...\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   - claude plugin tag .claude-plugin --push --remote origin  # plugin project の場合。default branch 上で実行\n   - git tag -a v\u003Cnew>                                        # GitHub Release 用 semver tag が必要な場合。default branch 上で作成\n   - git push origin \u003Cdefault-branch> --tags\n   - gh release create v\u003Cnew>\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 tag validation 失敗 | `VERSION` \u002F `.claude-plugin\u002Fplugin.json` \u002F marketplace entry の不一致を修正し、tag 作成には進まない |\n| push 失敗                  | リモート側の問題。ローカル commit\u002Ftag は残す                                                        |\n| `gh release create` 失敗   | tag は push 済みなので、既存の release.yml セーフティネットが発火するか、手動で `gh release create` |\n\n### PR \u002F Main Merge Gate\n\nPost-Gate の release commit 後は、tag を作る前に GitHub PR を default branch へ merge する。\n\n```bash\nrelease_branch=\"$(git branch --show-current)\"\ndefault_branch=\"${HARNESS_RELEASE_DEFAULT_BRANCH:-main}\"\n\ngit push -u origin \"$release_branch\"\ngh pr create --base \"$default_branch\" --head \"$release_branch\" --title \"chore: release v\u003Cnew>\" --body \"\u003Crelease summary>\"\ngh pr merge --merge --delete-branch=false\n\ngit fetch origin \"$default_branch\" --tags\ngit checkout \"$default_branch\"\ngit pull --ff-only origin \"$default_branch\"\ngit merge-base --is-ancestor \"\u003Crelease-commit>\" \"origin\u002F$default_branch\"\n```\n\n既存 PR がある場合は新規作成せず、既存 PR の body を更新して merge する。repository policy が squash merge を要求する場合は、release commit hash ではなく release bump の内容（version files + CHANGELOG + source commits）が default branch に含まれることを確認する。\n\ntag はこの Gate 完了後、default branch の HEAD もしくは release commit 到達可能な commit に対して作る。release branch 上だけに存在する commit を指す tag で GitHub Release を作ってはいけない。\n\n### Claude plugin project の tag 作成\n\n`.claude-plugin\u002Fplugin.json` がある project では、PR\u002Fmain merge 後に default branch 上でもう一度 version sync を確認してから plugin tag を作る:\n\n```bash\nHARNESS_PLUGIN_ROOT=\"${CLAUDE_PLUGIN_ROOT:-.}\"\npython3 \"${HARNESS_PLUGIN_ROOT}\u002Fscripts\u002Fcheck-release-version-sync.py\" --root .\n\nclaude plugin tag .claude-plugin --dry-run\nclaude plugin tag .claude-plugin --push --remote origin\n```\n\n`claude plugin tag` が作る tag は `{plugin-name}--v{version}` 形式。既存の GitHub Release workflow が `vX.Y.Z` tag を前提にしている project では、plugin tag とは別に `git tag -a v\u003Cnew>` を作る。plugin 配布の tag は `claude plugin tag` に任せ、GitHub Release 用 semver tag は release automation の互換 surface として扱う。\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 .` と `claude plugin tag .claude-plugin --dry-run` を実行し、実際に作られる plugin tag 名と push 対象を表示する。ここで `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 Release 作成をスキップ            |\n\n## CHANGELOG 書き方ルール\n\n`[Unreleased]` セクションは必ず以下のいずれかのサブセクションを持つ:\n\n```markdown\n## [Unreleased]\n\n### Added ← minor\n\n### Changed ← patch\n\n### Deprecated ← minor\n\n### Removed ← major\n\n### Fixed ← patch\n\n### Security ← patch\n\n### Breaking Changes ← major (Keep a Changelog 非標準だが一般的)\n```\n\nこのスキルはこれらの見出しを機械的に解析するため、見出しの表記揺れ（`### Fix` \u002F `### Bug Fixes` 等）は認識できません。KaCL 標準の見出しを使用してください。\n\n## 関連スキル\n\n- `harness-release-internal` - 本体 claude-code-harness のリリース時に追加で走らせる harness 固有 preflight\u002Ffinalization（配布対象外）\n- `harness-plan` - Plans.md 管理\n- `harness-review` - リリース前のコードレビュー\n\n## 設計思想\n\n- **単一ゲート**: ユーザーの判断タイミングは 1 回だけ。mini-confirmation を挟むとラバースタンプ化して意味を失う\n- **事前に全て描く**: Post-Gate に入ってからの「考え直し」を禁ずる。Gate 前に全 draft を揃える\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},"main","44656ee607735b31d88e298752f574936b85af75","agent-harnesses\u002Fclaude-code-harness\u002Fopencode\u002Fskills\u002Fharness-release","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal","https:\u002F\u002Fgithub.com\u002FTimothy191","2026-07-24 02:57:18",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add Timothy191\u002Farch-systems-portal --skill harness-release",{"tool":35,"command":36},"bunx","bunx skills add Timothy191\u002Farch-systems-portal --skill harness-release",{"tool":38,"command":39},"pnpm","pnpm dlx skills add Timothy191\u002Farch-systems-portal --skill harness-release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fopencode\u002Fskills\u002Fharness-release\u002FSKILL.md",true,[],[44,50,56,63,70,77],{"skillNo":45,"name":46,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":47,"categories":48,"keywords":49,"publishedAt":18},"01M79BVF4ZP6Z3GH36Y7BAAZHE","escape-skill","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Ftests\u002Ffixtures\u002Fskills\u002Fzz-review-escape\u002FSKILL.md",[],[],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M79BVE0FF9QC71P53B18GCQ8","zz-review-empty","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Ftests\u002Ffixtures\u002Fskills\u002Fzz-review-empty\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M79BVAB0TARBFRF4MCQ1T8AG","workflow-guide","Explicit helper for Cursor PM ↔ Claude Code two-agent workflow guidance. Do NOT load for: solo implementation, workflow setup, handoff execution, or general process coaching.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fworkflow-guide\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M79BV634WBDSVR8DXAHMHA19","vibecoder-guide","Explicit helper for non-technical VibeCoder coaching: what to ask next, how to describe work, and how to stay safe. Do NOT load for: direct implementation, technical review, or Cursor\u002FPM workflow.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fvibecoder-guide\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M79BV2G6901RYQGBT3QWDK64","ui","Explicit helper for UI components, hero sections, forms, feedback, and contact surfaces. Do NOT load for: authentication, backend implementation, database work, or business logic.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fui\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M79BTW2QT48HNNS9NCKE8PAH","session","Unified session management window. Handles initialization, memory, state all-in-one. Explicit \u002Fsession invocation only — sub-skills handle auto-delegation. Use when managing Claude Code sessions, \u002Fsession command. Do NOT load for: app user sessions, login state, authentication features.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fsession\u002FSKILL.md",[],[]]