Menu
本番リリース手順ガイド。「リリース」「本番リリース」「拡張機能をリリース」「vsixを作成」「Marketplaceに公開」「バージョンを上げてリリース」などの指示で使用する。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
/Shared/anytime-markdown-docs 配下のドキュメントを新規作成・執筆する時に、type（spec/tech/test/manual/proposal/plan/review/report）ごとの記載内容（何を書くか）・フォルダ構成・索引 index.[lang].md の自動生成運用を定義する。設計書（spec）の書き方・component spec の 2 ファイル分離・E2E シナリオ表・技術解説記事（tech。「技術記事を書いて」「ブログ記事を作成」「解説記事を書いて」等）の構成テンプレート・執筆ガイドライン・文体・生成ワークフロー・試験設計書（「試験設計書」「テスト設計書」「テストケースを設計」「テスト観点で洗い出し」「テスト計画」「QA 設計」等。7 ペルソナ観点・技法・自動化判定）・プランファイルの「変更対象ファイル」節・索引再生成が必要な時に使用する。構文・フロントマター・整形は anytime-markdown-output、既存設計書の読み方・辿り方は anytime-spec-lookup を使う。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
コードレビュー結果を出力する際の Markdown 書式（memory-core ingest パーサ対応）。### N. タイトル＋重大度/カテゴリ/対象の3メタデータ＋行頭の問題:/提案: マーカーで指摘を構造化する。レビュードキュメント・code-reviewer subagent 出力・requesting-code-review/security-review の指摘を書く時に使用する。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
Markdown ドキュメント（spec/tech/test/manual/proposal/plan/review/report）を出力・編集する際の構文・フロントマター・整形規約。/Shared/anytime-markdown-docs/ 配下に .md を作成/更新する時、見出し・テーブル・コードブロック・脚注・アドモニション・図表・フロントマター(type/c4Scope 等)を書く時、Markdown 出力仕様を確認する時に使用する。
anytime-markdown の設計書（/Shared/anytime-markdown-docs/spec）を低トークンで辿るためのナビゲーション手順。索引(index.ja.md) → 対象 frontmatter → 型付き related を必要な深さだけ辿る progressive disclosure。設計書の調査・参照・関連ドキュメント探索・「どの spec を読むべきか」を判断する時に使用する。
| name | production-release |
| description | 本番リリース手順ガイド。「リリース」「本番リリース」「拡張機能をリリース」「vsixを作成」「Marketplaceに公開」「バージョンを上げてリリース」などの指示で使用する。 |
更新日: 2026-07-09
anytime-markdown / anytime-graph / anytime-trail / anytime-database / anytime-sheet / anytime-agent / anytime-history / anytime-extension-pack VS Code 拡張機能および web-app のリリース手順。
git branch --show-current # develop ブランチであること
git status # 未コミット変更がないこと
git pull origin develop # 最新化
未コミット変更がある場合はユーザーに確認する。develop 以外のブランチの場合は警告する。
失敗時: develop 以外のブランチにいる場合は git checkout develop で切り替え。未コミット変更がある場合はユーザーに stash / commit / discard のいずれかを確認してから続行。
リリースの単位は CI の publish ジョブ（タグで公開判定） が定義する。同一系統内の「同期セット」パッケージは常に同一バージョンを維持すること。 各系統のバージョンは独立している。
[!IMPORTANT] publish はそのジョブが参照する 拡張機能 package.json の version で判定し、
<tag-prefix><version>のタグが未作成なら公開する。同期セット外のパッケージ（vendored tiptap・各 core/server/viewer の独立バージョン）は bump 対象外で、webpack バンドルにそのまま同梱されるためバージョンを上げる必要はない。
| 系統 | publish ジョブ / タグ | 同期セット（手動 bump 対象） | 備考 |
|---|---|---|---|
| markdown 系 | publish-markdown / v<x> | package.json (root), packages/mcp-markdown, packages/markdown-viewer, packages/markdown-rich, packages/vscode-markdown-extension | markdown-core は vendored tiptap で 0.0.0 固定・bump 対象外。version.ts の APP_VERSION は root を動的参照 |
| graph 系 | publish-graph / graph-v<x> | packages/graph-core, packages/mcp-graph, packages/vscode-graph-extension | graph-viewer は独立バージョン |
| trail 系 | publish-trail / trail-v<x> | packages/trail-core, packages/vscode-trail-extension | trail-server / trail-viewer / trail-db / mcp-trail / memory-core / agent-core は独立・bump 対象外（webpack 同梱）。VSIX は per-platform 4 種（build-trail matrix: linux/win32 × x64/arm64） |
| database 系 | publish-database / database-v<x> | packages/database-core, packages/database-viewer, packages/vscode-database-extension | VSIX は per-platform 4 種（build-database matrix: linux/win32 × x64/arm64。darwin なし） |
| sheet 系 | publish-sheet / sheet-v<x> | packages/spreadsheet-core, packages/spreadsheet-viewer, packages/vscode-sheet-extension | — |
| agent 系 | publish-agent / agent-v<x> | packages/vscode-agent-extension | agent-core は独立バージョン |
| history 系 | publish-history / history-v<x> | packages/vscode-history-extension | trace-core / trace-viewer / trace-agent-node は独立バージョン |
| extension pack 系 | publish-extension-pack / pack-v<x> | packages/vscode-extension-pack | メタパッケージ |
| web-app 系 | （Marketplace 公開なし。master push で Netlify 自動デプロイ） | packages/web-app | タグなし。markdown-* / graph-core の変更を取り込む |
| cms 系 | （Marketplace 公開なし。CI test のみ） | packages/cms-core, packages/mcp-cms | — |
| cms-remote 系 | deploy-mcp-cms-remote.yml（Cloudflare Workers） | packages/mcp-cms-remote | deploy-cms-remote スキル参照 |
[!NOTE] per-platform 系（trail / database）の VSIX（各 4 種）は CI（
ci.ymlのbuild-trail/build-databasematrix →publish-trail/publish-database）が自動生成・自動公開する。旧build-anytime-database.ymlはci.ymlに統合済み。darwin ターゲットは現在ビルドしていない。
バージョン管理ルール:
系統間のバージョンは独立している（markdown 0.10.1 と graph 0.1.0 が共存可能）
npm run version:sync は使用禁止。 全ワークスペースに影響し、意図しないパッケージのバージョンを書き換えるため
バージョン更新は各 package.json の version フィールドを直接編集する
バージョン更新後は全パッケージのバージョンを一覧表示して整合性を確認する:
for dir in . packages/*/; do name=$(node -p "require('./$dir/package.json').name" 2>/dev/null) && ver=$(node -p "require('./$dir/package.json').version" 2>/dev/null) && printf "%-45s %s\n" "$name" "$ver"; done
リリース対象の自動検出:
前回リリース（master の HEAD）以降に変更があるパッケージを特定し、対応する系統を列挙する。
# master との差分でパッケージごとの変更ファイル数を表示
git diff --stat origin/master...HEAD -- packages/ | grep 'packages/' | sed 's|/.*||' | sort | uniq -c | sort -rn
変更が検出された系統のみをリリース対象とする。変更がない系統はスキップする。
系統ごとのバージョンアップ確認:
リリース対象の各系統について、変更内容を要約し、ユーザーに patch / minor / major を1系統ずつ確認する。
例:
[graph 系] 0.1.0 → 変更: useCanvasBase の型エラー修正、選択矩形カラー定数削除
→ patch (0.1.1) / minor / major ?
[web-app 系] 0.10.1 → 変更: C4 Viewer の GitHub 連携、/docs/view でのドキュメント表示
→ patch / minor (0.11.0) / major ?
ユーザーの回答に基づいて各系統のバージョンを更新する。
markdown 系の更新:
# 以下4つの package.json の version フィールドを手動で同一バージョンに更新
# - package.json (root)
# - packages/markdown-core/package.json
# - packages/mcp-markdown/package.json
# - packages/vscode-markdown-extension/package.json
更新後、上記4ファイルのバージョンが統一されていることを確認。
packages/markdown-viewer/src/version.ts の APP_VERSION はルート package.json を動的参照するため手動更新不要。
graph 系の更新:
# 各 package.json の version を手動で更新
# graph-core, mcp-graph, vscode-graph-extension の3つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/graph-core/package.jsonpackages/mcp-graph/package.jsonpackages/vscode-graph-extension/package.jsontrail 系の更新:
# 各 package.json の version を手動で更新
# trail-core, vscode-trail-extension の2つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/trail-core/package.jsonpackages/vscode-trail-extension/package.jsondatabase 系の更新:
# 各 package.json の version を手動で更新
# database-core, database-viewer, vscode-database-extension の3つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/database-core/package.jsonpackages/database-viewer/package.jsonpackages/vscode-database-extension/package.jsoncms 系の更新:
# 各 package.json の version を手動で更新
# cms-core, mcp-cms の2つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/cms-core/package.jsonpackages/mcp-cms/package.jsonsheet 系の更新:
# spreadsheet-core, spreadsheet-viewer, vscode-sheet-extension の3つを同一バージョンに統一
単独系統の更新（各 package.json の version を手動で更新）:
packages/vscode-agent-extension/package.jsonpackages/vscode-history-extension/package.jsonpackages/mcp-cms-remote/package.jsonpackages/web-app/package.jsonpackages/vscode-extension-pack/package.json注意: 各系統のバージョンは独立している。npm run version:sync は使用禁止。すべて手動更新する。
リリース対象に応じて CHANGELOG を更新する。各パッケージには CHANGELOG.md（英語）と CHANGELOG.ja.md（日本語）の2ファイルが存在する。両方を同時に更新すること。 形式は Keep a Changelog。
CHANGELOG.md: 英語版（セクションヘッダー: Added / Changed / Fixed / Removed / Security）CHANGELOG.ja.md: 日本語版（セクションヘッダー: 追加 / 変更 / 修正 / 削除 / セキュリティ）## [x.y.z] - YYYY-MM-DD
### Added
- 新機能
### Changed
- 変更
### Fixed
- バグ修正
develop ブランチの最新コミットログを参照してエントリ内容を作成する。ユーザーに内容を確認してもらう。
各モジュールの CHANGELOG 記載ルール:
各パッケージの CHANGELOG にはそのパッケージ固有の変更のみを記載する。共通機能は担当パッケージに記載し、重複記載しない。
| CHANGELOG | 記載する内容 | 記載しない内容 |
|---|---|---|
packages/markdown-viewer/CHANGELOG.md | エディタコア機能（Tiptap、コンポーネント、拡張機能、スタイル、セキュリティ）。markdown-rich 固有変更も含む | VS Code 固有、web-app 固有、CI/CD。markdown-core（vendored tiptap）は CHANGELOG なし |
packages/vscode-markdown-extension/CHANGELOG.md | VS Code 拡張固有（Custom Editor、treeview、webview、activationEvents、ステータスバー移行等）+ ### Editor Core (markdown-viewer / markdown-rich) セクションにエディタコア更新の要約 | web-app 固有、CI/CD、git treeview、graph editor |
packages/web-app/CHANGELOG.md | web-app 固有（ランディングページ、CMS、/docs、C4 Viewer、Next.js、SEO、Auth.js、PWA、Dockerfile）+ CI/CD（GitHub Actions、SonarCloud、e2e テスト） | VS Code 固有、エディタコア |
packages/graph-core/CHANGELOG.md | グラフエンジンコア（ノード、エッジ、キャンバス、レイアウト、エクスポート、アクセシビリティ） | VS Code 固有 |
packages/vscode-graph-extension/CHANGELOG.md | VS Code Graph 拡張固有（Custom Editor、テーマ、設定パネル）+ ### Graph Core (graph-core) セクションに graph-core 更新の要約 | graph-core 詳細 |
packages/trail-viewer/CHANGELOG.md | Trail / C4 ビューア UI コンポーネント（ツリー、グラフ、DSM、ツールバー、C4/C5 レベル） | VS Code 固有、サーバー固有 |
packages/trail-core/CHANGELOG.md | Trail コア機能（タイムライン、アクティビティ追跡、C4 グラフフィルタ） | VS Code 固有 |
packages/vscode-trail-extension/CHANGELOG.md | VS Code Trail 拡張固有 + ### Trail Core (trail-core / trail-server / trail-viewer) セクションにコア・サーバー・ビューア更新の要約 | 各コア詳細 |
packages/database-core/CHANGELOG.md | データベースアダプタ層（DatabaseAdapter, SqlJsAdapter, BetterSqlite3Adapter, PaginatedSqlSheetAdapter, FK 推定、識別子バリデーション） | VS Code 固有、UI 固有 |
packages/database-viewer/CHANGELOG.md | データベース UI コンポーネント（DatabaseEditor, ErdView, TableTree, ResultGrid, SqlEditorPanel） | VS Code 固有、コア詳細 |
packages/vscode-database-extension/CHANGELOG.md | VS Code Database 拡張固有（Custom Editor、Activity Bar パネル、l10n、per-platform VSIX）+ ### Database Core (database-core / database-viewer) セクションに更新の要約 | コア詳細、UI 詳細 |
packages/cms-core/CHANGELOG.md | CMS コア機能（S3 操作、ドキュメント管理、レポート管理） | web-app 固有、VS Code 固有 |
packages/mcp-cms/CHANGELOG.md | MCP CMS サーバー固有（MCP ツール定義、サーバー設定） | CMS コア詳細 |
packages/mcp-cms-remote/CHANGELOG.md | CMS Remote サーバー固有（Cloudflare Workers、リモート MCP） | CMS コア詳細 |
packages/vscode-extension-pack/CHANGELOG.md | パック構成の変更（含まれる拡張機能の追加/削除） | 個別拡張機能の詳細 |
VS Code 拡張での core パッケージ要約の書き方:
VS Code 拡張の CHANGELOG には、各バージョンにコアパッケージの更新要約セクションを設ける。日本語で簡潔に要約する（1エントリ1行、主要機能のみ）。詳細は各 core パッケージの CHANGELOG を参照。
vscode-markdown-extension → ### Editor Core (markdown-core) セクションvscode-graph-extension → ### Graph Core (graph-core) セクションvscode-trail-extension → ### Trail Core (trail-core) セクションvscode-database-extension → ### Database Core (database-core / database-viewer) セクション## [x.y.z] - YYYY-MM-DD
### Added
- VS Code 拡張固有の変更
### Editor Core (markdown-core)
- エディタコアの主要な変更の要約
## [x.y.z] - YYYY-MM-DD
### Added
- VS Code Graph 拡張固有の変更
### Graph Core (graph-core)
- グラフコアの主要な変更の要約
npm audit
critical / high の脆弱性がある場合は、該当パッケージを更新してから次のステップに進むこと（PR 作成前の必須ゲート）。更新時は型チェック・テストで互換性を確認する。
失敗時: 脆弱性パッケージの更新後は Step 5 のテスト・ビルド検証を再実行して互換性を確認。更新で破壊的変更が入る場合はユーザーに判断を仰ぐ。
ワークスペースごとに個別実行する。npm test --workspaces は使用しない。 1コマンドで全ワークスペースを流すと、失敗箇所の特定が困難になり、途中停止で後続テストが未実行になるため。
# 5-1: 型チェック・lint・スキルゲート
npx tsc --noEmit
npm run lint # 注: root の lint 実体は `eslint packages/markdown-viewer/src packages/web-app/src` のみ。graph 系・trail 系・database 系等は lint 対象外
npm run check-skills # 同梱スキルの byte 一致 + 参照実在性 lint + SHORTCUT ゲート + scripts テスト。develop push の CI が回すのでローカルでも必須
# 5-2: ユニットテスト（ワークスペースごとに個別実行）
# 注: markdown-core は vendored tiptap でテスト無し（`--passWithNoTests` を付けないと exit 1）。
# エディタコアのテスト実体は markdown-viewer / markdown-rich にある。
cd packages/markdown-viewer && npx jest --coverage --maxWorkers=1
cd packages/markdown-rich && npx jest --coverage --passWithNoTests --maxWorkers=1
cd packages/mcp-markdown && npx jest --coverage --maxWorkers=1
cd packages/graph-core && npx jest --coverage --maxWorkers=1
cd packages/mcp-graph && npx jest --coverage --maxWorkers=1
cd packages/trail-core && npx jest --coverage --passWithNoTests --maxWorkers=1
cd packages/database-core && npx jest --coverage --maxWorkers=1
cd packages/database-viewer && npx jest --coverage --maxWorkers=1
cd packages/cms-core && npx jest --coverage --maxWorkers=1
cd packages/mcp-cms && npx jest --passWithNoTests --maxWorkers=1
cd packages/mcp-cms-remote && npx jest --coverage --passWithNoTests --maxWorkers=1
cd packages/web-app && npx jest --coverage --passWithNoTests --maxWorkers=1
# 5-3: E2E・カバレッジ・ビルド
cd packages/web-app && E2E_COVERAGE=1 npx playwright test --project=chromium
cd packages/web-app && npx next build
cd packages/vscode-markdown-extension && npx webpack --mode production
cd packages/vscode-graph-extension && npx webpack --mode production
cd packages/vscode-trail-extension && npx webpack --mode production
cd packages/vscode-database-extension && npx webpack --mode production
各コマンドの結果を個別に確認し、全て通過してから次のステップに進む。 graph 系のみのリリースでも全テスト・全ビルドを実行する（依存関係の影響を検出するため）。
npm run lint と同じチェック）。root の lint 実体は eslint packages/markdown-viewer/src packages/web-app/src のみで、graph 系・trail 系・database 系等は lint 対象外。--update-snapshots を打たない。 祖先要素の小数高さ（例: ボタン行 39.39px）による sub-pixel ずれだと、見た目は変わっていないのに複数スナップショットが落ちる。origin/master を worktree に出して同じ VR を走らせ（node_modules は main へ symlink）、master で pass するならローカル環境差ではなくコード起因。差分画像を読み、要素の getBoundingClientRect() の top が整数かを確認してから、ベースライン更新か実装修正かを決める。e2e:coverage は Chromium のみで実行し、coverage/coverage-final.json（Istanbul 形式）を出力する。出力されたカバレッジファイルのファイル数をコンソールで確認する（E2E coverage: N files → のログ）。C4 モデルビューアでカバレッジを読み込み、対象ファイルのカバレッジ状況を視覚的に確認する。next build が失敗した場合は修正してから次のステップに進むこと（Netlify デプロイと同じビルドコマンド）。vscode-test はコンテナ環境でネットワークエラーになる場合があるため無視してよい。失敗時:
tsc --noEmit 失敗 → 型エラーを修正してから再実行。npm run lint 失敗 → lint エラーを修正してから再実行。CI と同じ ESLint ルールが適用される。lint 修正後は必ず npx tsc --noEmit と全ユニットテストを再実行すること。 lint の autofix や手動修正で型エラーやテスト失敗が発生する場合がある。e2e:coverage 失敗 → スクリーンショットやトレースを確認し、UI変更による期待値のずれか実際のバグかを切り分ける。カバレッジが出力されない場合は .v8-coverage/ の生成状況と dev サーバーのソースマップ提供を確認する。next build 失敗 → Netlify デプロイで同じエラーが発生する。依存パッケージのバージョン不整合が主な原因。npm ls <package> で重複バージョンを確認し、overrides で統一する。webpack 失敗 → ビルドログの最初のエラーから対処。依存関係の問題なら npm ci を再実行。リリース対象に応じて VSIX を生成する:
markdown 系:
cd packages/vscode-markdown-extension
npx vsce package --no-dependencies
anytime-markdown-<version>.vsix が生成されることを確認する。
graph 系:
cd packages/vscode-graph-extension
npx vsce package --no-dependencies
anytime-graph-<version>.vsix が生成されることを確認する。
trail 系（per-platform、4 VSIX）:
anytime-trail は better-sqlite3 のネイティブバイナリを含むため per-platform 配布が必要。
ci.yml の build-trail matrix が develop / master push 時に 4 プラットフォーム
（linux/win32 × x64/arm64。darwin なし）の VSIX を自動生成する。
ローカル検証では単一プラットフォーム（実行環境）の VSIX のみ生成する:
cd packages/vscode-trail-extension
npx vsce package --no-dependencies
anytime-trail-<version>.vsix が生成されることを確認する。
本番リリース時の per-platform VSIX 4 種は CI で自動生成・自動公開される。
database 系（per-platform、4 VSIX）:
anytime-database も better-sqlite3 を含むため per-platform 配布が必要。
ci.yml の build-database matrix が develop / master push 時に 4 プラットフォーム
（linux/win32 × x64/arm64。darwin なし）の VSIX を自動生成する。
ローカル検証では単一プラットフォーム（実行環境）の VSIX のみ生成する:
cd packages/vscode-database-extension
npx @vscode/vsce package --no-dependencies
anytime-database-<version>.vsix が生成されることを確認する。
本番リリース時の per-platform VSIX 4 種は CI で自動生成・自動公開される。
sheet 系:
cd packages/vscode-sheet-extension
npx vsce package --no-dependencies
anytime-sheet-<version>.vsix が生成されることを確認する。
agent 系:
cd packages/vscode-agent-extension
npx vsce package --no-dependencies
anytime-agent-<version>.vsix が生成されることを確認する。
history 系:
cd packages/vscode-history-extension
npx vsce package --no-dependencies
anytime-history-<version>.vsix が生成されることを確認する。
extension pack 系:
cd packages/vscode-extension-pack
npx vsce package
anytime-extension-pack-<version>.vsix が生成されることを確認する。
リリース対象の VSIX を自動インストールしてから、ユーザーに動作確認を依頼する。
# リリース対象の拡張機能を自動インストール（対象系統のみ実行）
# markdown 系
code --install-extension packages/vscode-markdown-extension/anytime-markdown-<version>.vsix
# graph 系
code --install-extension packages/vscode-graph-extension/anytime-graph-<version>.vsix
# trail 系
code --install-extension packages/vscode-trail-extension/anytime-trail-<version>.vsix
# database 系（ローカル単一プラットフォーム）
code --install-extension packages/vscode-database-extension/anytime-database-<version>.vsix
# extension pack 系
code --install-extension packages/vscode-extension-pack/anytime-extension-pack-<version>.vsix
本番リリース依頼を受けている状態のため、通常の push 操作時にユーザー確認は挟まない。リリース依頼自体が push の承認にあたる。
git add -A
git commit -m "release: v<version>"
git push origin develop
失敗時: push が rejected された場合は git pull --rebase origin develop で最新を取り込んでから再 push。コンフリクトが発生した場合はユーザーに確認。
push 後に GitHub Actions（CI / Publish VS Code Extension ワークフローの ci ジョブ）の完了を待つ。
develop push の CI は高速フィードバック用で、以下のみ実行される:
ユニットテスト・e2e・ビルド・VSIX 作成・audit は master PR で実行されるため、develop push では省略される。Step 5 でローカル実行済みのため、CI での再実行は不要。
注意: 修正の規模に関わらず、コード変更後は必ず Step 5 からやり直すこと。「軽微な修正だから lint だけ」という例外は認めない。
Step 5 通過後、Step 9（PR マージ）までの間にコード修正が発生した場合は、修正規模に関わらず必ず Step 5 に戻って全検証を再実行する。 rebase や force push が発生した場合も同様。
develop → master の PR を作成してマージする。
gh pr create --base master --head develop --title "release: v<version>" --body "v<version> リリース"
失敗時: マージコンフリクトが発生した場合は、develop 上で git merge master してコンフリクトを解決 → 再 push → PR を再作成。
master PR の CI は品質ゲートとして全項目を実行する:
master PR の CI が全通過したらマージする。
master へのマージ後、GitHub Actions が自動で以下を実行する（markdown 系・graph 系・trail 系・database 系・sheet 系・agent 系・history 系・extension pack 系それぞれ独立した publish ジョブ）:
ci.yml の CI ジョブで拡張機能ビルド・VSIX を作成（テスト等は master push ではスキップ）ci.yml の build-trail / build-database matrix が per-platform で各 4 VSIX を生成し、続けて publish-trail / publish-database ジョブを実行v<version>、graph 系: graph-v<version>、trail 系: trail-v<version>、database 系: database-v<version>、sheet 系: sheet-v<version>、agent 系: agent-v<version>、history 系: history-v<version>、extension pack 系: pack-v<version>）GitHub Actions の実行結果を確認する:
gh run list --repo anytime-trial/anytime-markdown --branch master --limit 1 で成功を確認失敗時: Actions が失敗した場合は gh run view --log-failed でエラーログを確認。VSCE_PAT の期限切れが多い。手動公開で対応する:
手動公開が必要な場合:
A. CLI で公開:
# markdown 系
cd packages/vscode-markdown-extension
npx vsce publish --no-dependencies --pat <token>
# graph 系
cd packages/vscode-graph-extension
npx vsce publish --no-dependencies --pat <token>
# trail 系（per-platform、4 VSIX を一括 publish）
cd packages/vscode-trail-extension
# 事前に ci.yml の build-trail artifact から 4 VSIX をダウンロードしておくこと
npx @vscode/vsce publish --packagePath \
anytime-trail-linux-x64.vsix \
anytime-trail-linux-arm64.vsix \
anytime-trail-win32-x64.vsix \
anytime-trail-win32-arm64.vsix \
--pat <token>
# database 系（per-platform、4 VSIX を一括 publish）
cd packages/vscode-database-extension
# 事前に ci.yml の build-database artifact から 4 VSIX をダウンロードしておくこと
npx @vscode/vsce publish --packagePath \
anytime-database-linux-x64.vsix \
anytime-database-linux-arm64.vsix \
anytime-database-win32-x64.vsix \
anytime-database-win32-arm64.vsix \
--pat <token>
# sheet / agent / history 系
cd packages/vscode-sheet-extension && npx vsce publish --no-dependencies --pat <token>
cd packages/vscode-agent-extension && npx vsce publish --no-dependencies --pat <token>
cd packages/vscode-history-extension && npx vsce publish --no-dependencies --pat <token>
# extension pack 系
cd packages/vscode-extension-pack
npx vsce publish --pat <token>
B. 手動アップロード:
.vsix ファイルをアップロードpublisher: anytime-trial
master の CI または publish が失敗し、Marketplace に公開されていない場合:
失敗原因を特定（gh run view --log-failed）
develop で修正 → Step 5 からやり直し
修正後、再度 develop → master PR を作成・マージ
同一バージョンのタグが既存の場合は自動スキップされるため、タグを削除してから再マージ:
# markdown 系
git push origin --delete v<version>
git tag -d v<version>
# graph 系
git push origin --delete graph-v<version>
git tag -d graph-v<version>
# trail 系
git push origin --delete trail-v<version>
git tag -d trail-v<version>
# database 系
git push origin --delete database-v<version>
git tag -d database-v<version>
Marketplace に公開済みで問題が発覚した場合:
[ ] develop ブランチが最新
[ ] バージョンが各系統内で統一（リリース対象の系統）
[ ] CHANGELOG 更新済み（リリース対象の系統）
[ ] npm audit で critical/high 脆弱性なし
[ ] tsc --noEmit 通過
[ ] npm run lint 通過
[ ] npm run check-skills 通過
[ ] npm test 全ユニットテスト通過（markdown-viewer / markdown-rich）
[ ] npm test 全ユニットテスト通過（mcp-markdown）
[ ] npm test 全ユニットテスト通過（graph-core）
[ ] npm test 全ユニットテスト通過（mcp-graph）
[ ] npm test 全ユニットテスト通過（trail-core）
[ ] npm test 全ユニットテスト通過（database-core）
[ ] npm test 全ユニットテスト通過（database-viewer）
[ ] npm test 全ユニットテスト通過（cms-core）
[ ] npm test 全ユニットテスト通過（mcp-cms）
[ ] npm test 全ユニットテスト通過（mcp-cms-remote）
[ ] npm test 全ユニットテスト通過（web-app）
[ ] e2e テスト通過（packages/web-app）
[ ] E2E カバレッジ出力確認（coverage/coverage-final.json）
[ ] next build 通過（packages/web-app）
[ ] webpack ビルド通過（packages/vscode-markdown-extension）
[ ] webpack ビルド通過（packages/vscode-graph-extension）
[ ] webpack ビルド通過（packages/vscode-trail-extension）
[ ] webpack ビルド通過（packages/vscode-database-extension）
[ ] VSIX 生成済み（リリース対象の拡張機能・extension pack。trail 系・database 系は ci.yml の build-trail / build-database で各 4 VSIX を CI 生成）
[ ] ローカルテスト完了
[ ] コミット・push 済み
[ ] CI 検証ゲート通過（GitHub Actions の ci ジョブが全通過）
[ ] develop → master PR マージ済み
[ ] GitHub Actions 成功（タグ自動作成・公開完了）
ワークフロー: .github/workflows/ci.yml（per-platform ビルドを含め一本化済み）
ci.yml: CI ジョブ（テスト + ビルド + 拡張機能の VSIX 作成）→ publish-markdown / publish-graph / publish-history / publish-trail / publish-sheet / publish-agent / publish-database / publish-extension-pack ジョブ（並行実行、各 CI の VSIX を取得 → vsce publish → タグ作成 → GitHub Release 作成）build-trail / build-database matrix（4 プラットフォーム = linux/win32 × x64/arm64、darwin なし）が各 4 VSIX を生成 → publish-trail / publish-database ジョブが一括 publish → タグ作成 → GitHub Release 作成v<version>、graph 系: graph-v<version>、history 系: history-v<version>、trail 系: trail-v<version>、sheet 系: sheet-v<version>、agent 系: agent-v<version>、database 系: database-v<version>、extension pack 系: pack-v<version>）VSCE_PAT（Azure DevOps Personal Access Token、全拡張機能で共有）All accessible organizations、Scopes: Marketplace > ManageVSCE_PAT、Value: コピーしたトークンpackages/vscode-markdown-extension/.vscodeignore でパッケージに含めないファイルを制御