메뉴
vk-orchestrator をリリースする。同梱する vk-terminals / vk-agents を最新にそろえてから、バージョン付与・CHANGELOG 確定・タグ push まで一気通貫で行う。「orchestrator をリリース」「vk-orchestrator-release」で起動。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | vk-orchestrator-release |
| description | vk-orchestrator をリリースする。同梱する vk-terminals / vk-agents を最新にそろえてから、バージョン付与・CHANGELOG 確定・タグ push まで一気通貫で行う。「orchestrator をリリース」「vk-orchestrator-release」で起動。 |
| compatibility | git、node、bash が必要。vk-agents の実体 clone（VK_AGENTS_DIR）が必要 |
vk-orchestrator のリリースは 「同梱依存（vk-terminals / vk-agents）を最新にそろえる」→「バージョン付与・CHANGELOG 確定」→「コミット・タグ・push」 の 3 フェーズ。 このスキルはその順序と抜け漏れ防止を担う。Phase 1 で同梱を最新化してからでないとリリースに進まないのが肝心。
vk-orchestrator は npm registry へ publish せず、利用側は git タグ（git+https://…#vX.Y.Z）で取り込む。CI リリースワークフローは無い。したがってリリース＝リリースコミット + lightweight タグ vX.Y.Z を main に push すること。
このリポジトリ（vk-orchestrator）で次を言われたとき：
package.json の name が vk-orchestrator）。違えば移動を促す。git checkout main && git pull --ff-only origin main
VK_AGENTS_DIR（未設定なら既知の兄弟配置）で解決する。同梱 vendor/vk-agents-public は export 生成物であり元リポジトリではない点に注意（Phase 1 のスクリプトが取り違えを検出してエラーにする）。Phase 1 → 2 → 3 は原則止まらず一気通貫で進める。 ただしリリースは破壊的（push・タグ）なので、次の 1 点だけは確定前に必ずユーザーへ提示・確認する：
これ以外はフェーズごとの逐一確認をしない。以下のときのみ止まる：Phase 1 がエラー（exit 2）／前提条件が欠けている／実行中にエラーで続行不可。
npm run release:preflight
scripts/release-preflight.mjs が次を行う（詳細はスクリプト冒頭コメント参照。ロジックはここに再実装しない）：
optionalDependencies のピンをリモート最新 semver タグへ追従（bump-vk-terminals.mjs latest を再利用。package.json / package-lock.json を書き換え）。export-public.sh を実行し、vendor/vk-agents-public を再生成（元リポの作業ツリーは汚さない）。終了コードで分岐する：
| exit | 意味 | 対応 |
|---|---|---|
| 0 | どちらも既に最新。差分なし | そのまま Phase 2 へ。CHANGELOG に依存更新行は不要 |
| 1 | 古かったので最新化した。未コミット差分あり（正常系） | 出力に出た新バージョン（vk-terminals タグ / vk-agents タグ）を控えて Phase 2 へ。差分はリリースコミットに含める |
| 2 | エラー（vk-agents リポ未解決・bump/export 失敗） | 止まる。出力を添えてユーザーへエスカレーション。推測で先へ進まない |
exit 1 のときにスクリプトが報告した版数（例: vk-terminals ピン → 1.43.0、vk-agents 同梱 → v0.13.0）と、更新前の版数を控える。更新前の vk-terminals ピンは次で取れる：
git show HEAD:package.json | node -e "let s='';process.stdin.on('data',d=>s+=d).on('end',()=>console.log(JSON.parse(s).optionalDependencies['vk-terminals'].match(/#(.+)$/)[1]))"
CHANGELOG.md 冒頭の未リリース領域（= x.y.z = 見出しより上）のエントリ分類から推奨値を算出する：
[ 機能追加 ] を含む → minor を上げる（例: 0.22.0 → 0.23.0）[ 不具合修正 ] / [ 仕様変更 ] のみ → patch（例: 0.22.0 → 0.22.1）現行バージョンは package.json の version。推奨値を提示し、ユーザーの合意を得る（唯一の確認ポイント）。
$VK_AGENTS_DIR/rules/changelog.md と change-title.md に従う（必ず読んでから）。
[ 仕様変更 ] vk-terminals を <旧> から <新> にアップデート（既存の 0.21.0 の記法に合わせる）[ その他 ] 同梱 vk-agents-public を vk-agents <新> に同期= X.Y.Z = を追加する（既存の確定済みセクションには手を入れない）。npm version X.Y.Z --no-git-tag-version
（package.json と package-lock.json の root version を同時更新。タグ・コミットはこの時点では作らない。Phase 1 で書き換えた vk-terminals ピンはそのまま残る。）
リリースコミットに含めるもの：CHANGELOG.md / package.json / package-lock.json、および Phase 1 で差分が出ていれば vendor/vk-agents-public。
git add CHANGELOG.md package.json package-lock.json vendor/vk-agents-public
git commit # メッセージは下記
git tag vX.Y.Z
git push origin main
git push origin vX.Y.Z
コミットメッセージ（既存の慣例に合わせる。依存を更新した場合は要約に併記）：
[ その他 ] リリース X.Y.Z として CHANGELOG に = X.Y.Z = 見出しを付与
- 同梱 vk-terminals を <旧> から <新> にアップデート # Phase 1 で更新があった場合のみ
- 同梱 vk-agents-public を vk-agents <新> に同期 # Phase 1 で更新があった場合のみ
push 後、タグ vX.Y.Z が origin に載ったことを確認して完了報告する：
git ls-remote --tags origin vX.Y.Z
rules/changelog.md / change-title.md が単一ソース。このスキルに再実装せず、必ず参照する。.github/workflows/sync-vk-terminals.yml）と up 起動時追従でも最新化されるが、リリース時点での最新保証は Phase 1 が担う（同期ワークフローの取りこぼしをここで吸収する）。メイン Claude がディレクター（司）として振る舞う。GitHub issue管理、和田（エンジニア）への実装指示、植草（UX）との連携・確認を統括する。
e2eテスト・UIテスト担当（麗美）をサブエージェントとして起動する。PRに対してPlaywrightでブラウザ操作テストを実施する。コードレビューはスコープ外。
GitHub issue の URL を受け取り、司（staff-director）が内容を分析→適切なメンバーに委任→完了確認→報告まで一貫して行う
VK Orchestrator の初回セットアップを対話で行う。doctor で不足項目を検知し、モード選択（ローカル/GitHub）→ 依存順のヒアリング → 3 ファイル（A/B/C）への保存 →（GitHub モード時のみ）ラベル登録 → 再 doctor で確認まで伴走する。
リードエンジニア（安藤保）をサブエージェントとして起動する。コード品質・レビューの最終責任者。設計・可読性・保守性・パフォーマンス・セキュリティの全般をレビュー。「安藤さん」「保さん」で呼び出し可能。
UIの設計提案・ユーザービリティレビューを行うUXデザイナー（植草）をサブエージェントとして起動する。要件レベルから画面設計の検討、アクセシビリティレビューまで対応。