القائمة
aituber-kit-docsのドキュメントサイトを最新バージョンに更新する。バージョンごとの差分を分析し、日本語→英語→中国語の順で3言語のドキュメントを更新する。ドキュメント更新、docs更新、バージョンアップ対応、リリースノート反映などの作業で使用する。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
aituber-kitでdevelop=>mainのPRをマージし、新しいマイナーバージョンをリリースする。フッターのver表記更新、PRチェックとCodeRabbit reviewThreads確認、PRマージ、ローカルmain最新化、軽量タグ作成・push、CodeRabbit文を除外したGitHub Release発行時に使用。
aituber-kitでdevelop=>mainのPRをマージし、新しいマイナーバージョンをリリースする。フッターのver表記更新、PRチェックとCodeRabbit reviewThreads確認、PRマージ、ローカルmain最新化、軽量タグ作成・push、CodeRabbit文を除外したGitHub Release発行時に使用。
aituber-kitでdevelopからmainへ向けるリリース用プルリクエストを作成・更新する。過去のdevelop=>main PR形式を参考に、PR本文を新機能/改善/バグ修正/テスト/ドキュメント・翻訳/その他の日本語セクションで作成し、CodeRabbit自動生成ブロックは含めない。developからmainへのPR作成、リリースPR作成、Develop => main PR作成時に使用。
日本語の翻訳ファイル（ja/translation.json）から他の言語ファイルに不足しているキーを同期し、READMEの変更も多言語READMEに反映する。翻訳キーの追加、翻訳ファイルの同期、i18nキーの更新、READMEの多言語同期時に使用。
全AIプロバイダーのAPIエンドポイント（チャット・TTS・STT・Embedding）を動作確認し、レポートを出力する。
日本語の翻訳ファイル（ja/translation.json）から他の言語ファイルに不足しているキーを同期し、READMEの変更も多言語READMEに反映する。翻訳キーの追加、翻訳ファイルの同期、i18nキーの更新、READMEの多言語同期時に使用。
| name | update-docs |
| description | aituber-kit-docsのドキュメントサイトを最新バージョンに更新する。バージョンごとの差分を分析し、日本語→英語→中国語の順で3言語のドキュメントを更新する。ドキュメント更新、docs更新、バージョンアップ対応、リリースノート反映などの作業で使用する。 |
| user-invocable | true |
aituber-kitのリリースバージョンに合わせて、VitePressドキュメントサイト（aituber-kit-docs）を更新する。
./aituber-kit-docs/guide/）、英語（/en/guide/）、中国語（/zh/guide/）現在のドキュメントバージョンと最新バージョンを特定する。
# docsの現在のバージョンを確認
grep "const version" ./aituber-kit-docs/.vitepress/theme/DocVersion.vue
# aituber-kitの利用可能なタグを確認
git tag --sort=-v:refname | head -10
複数バージョンの差がある場合は、1バージョンずつ順番に更新する。各バージョンでビルドが通る状態を保つ。
対象バージョン間の差分を以下のソースファイルから分析する。
| ソースファイル | 確認内容 |
|---|---|
.env.example | 新規・変更・削除された環境変数 |
src/features/constants/aiModels.ts | AIモデルリストの変更 |
src/features/constants/settings.ts | 設定型の追加・変更（AIService, AIVoice等） |
src/components/settings/ | 設定UIの変更（新タブ、新セクション） |
src/features/stores/settings.ts | ストアの新規設定項目 |
src/pages/api/ | 新規APIルート |
# .env.exampleの差分（最も重要）
diff <(git show v{前バージョン}:.env.example) <(git show v{対象バージョン}:.env.example)
# 特定バージョンのファイル内容を確認
git show v{対象バージョン}:src/features/constants/aiModels.ts
# 設定コンポーネントの構造変更
git diff v{前バージョン}..v{対象バージョン} -- src/components/settings/index.tsx
差分から以下のカテゴリに分類する:
| カテゴリ | ドキュメントファイル |
|---|---|
| クイックスタート | guide/quickstart.md |
| キャラクター共通 | guide/character/common.md |
| VRM設定 | guide/character/vrm.md |
| Live2D設定 | guide/character/live2d.md |
| PNGTuber設定 | guide/character/pngtuber.md |
| AI共通設定 | guide/ai/common.md |
| AIサービス設定 | guide/ai/model-provider.md |
| 合成音声設定 | guide/voice-settings.md |
| YouTube設定 | guide/youtube-settings.md |
| 会話履歴 | guide/conversation-history.md |
| 記憶設定 | guide/memory-settings.md |
| 環境変数一覧 | guide/environment-variables.md |
| 基本設定 | guide/basic-settings.md |
| その他 | guide/other/advanced-settings.md |
.env.exampleと完全に一致させるaiModels.tsのmodelDefinitionsから正確に転記する新しいドキュメントページを作成する場合:
guide/ に新規mdファイルを作成.vitepress/config.mts のサイドバー設定に追加（日本語/英語/中国語の3箇所）cd ./aituber-kit-docs && npm run docs:build
ビルドが成功することを必ず確認する。デッドリンクがある場合はエラーになるので修正する。
新規追加された環境変数が全てドキュメント化されているか検証する。
# .env.exampleから新規変数を抽出し、docsに記載があるか確認
cd ./aituber-kit-docs
for var in NEXT_PUBLIC_NEW_VAR1 NEXT_PUBLIC_NEW_VAR2; do
count=$(grep -rl "$var" guide/ | wc -l | tr -d ' ')
if [ "$count" = "0" ]; then
echo "MISSING: $var"
else
echo "OK ($count files): $var"
fi
done
各変数が個別設定ページと環境変数一覧ページの両方に記載されていること。
日本語の更新が完了したら、Agentを使って英語と中国語を並行で翻訳する。
en/guide/ と zh/guide/ に同名で作成英語翻訳エージェントと中国語翻訳エージェントを同時に起動する。
各エージェントには以下を伝える:
- 変更されたファイルの一覧
- 各ファイルの変更内容の要約
- 日本語ファイルとen/zh対応ファイルの両方を読んでから編集すること
- 完了後にnpm run docs:buildでビルド検証すること
# バージョン表示を更新
# .vitepress/theme/DocVersion.vue の version 定数を更新
コミット前に、新規追加・変更されたUI要素に対してスクリーンショットが必要かどうかを確認し、必要ならCodexが撮影・配置・ドキュメントへの参照追加まで行う。
）を参考に、同等の粒度でスクリーンショットが必要かを判断する./aituber-kit-docs/public/images/ に配置する{カテゴリ}_{ランダム5文字}.webp を基本とする（例: vrm_pose_a3b2c.webp） を追記するnpm run dev -- --port {空きポート} でローカルアプリを起動する1280x720 で撮影するcwebp（公式ツールで単純・高速）を使い、利用できない場合は Node.js 環境で扱いやすい sharp、最後に汎用的な ImageMagick の順でフォールバックするview_image や画像ビューアで視認性・トリミング・文字の見切れを確認するnpm run docs:build で画像参照とページ生成を検証するユーザーへの撮影依頼は、ログイン・CAPTCHA・実機操作などCodexだけでは撮影状態を作れない場合に限る。その場合も、必要な画像、配置先、想定ファイル名、撮影すべき画面状態を具体的に伝える。
cd ./aituber-kit-docs && npm run docs:build
ビルド成功を確認後、コミットする。コミットメッセージの形式:
docs: v{バージョン}対応 - {主要変更の要約}（日英中）
{詳細な変更内容をリスト形式で}
Co-Authored-By: Codex Opus 4.6 <noreply@anthropic.com>
aiModels.ts の modelDefinitions を読み、以下を更新:
guide/ai/model-provider.md のモデルリストguide/environment-variables.md のデフォルトモデル名guide/voice-settings.md のエンジンリストと個別セクションguide/environment-variables.md の音声合成セクションsrc/components/settings/index.tsx で新タブを確認.vitepress/config.mts のサイドバーに追加（3言語分）guide/environment-variables.md に環境変数セクションを追加