コンテンツにスキップ
Physical AI の最前線へようこそ

共同編集者向けガイド：AI Skills ワークフローと運用基準

Mujin Gemba Walk 共同編集者向けガイドへようこそ！

このサイトは、採用チーム（Talent Acquisition）や候補者向けの公開「Wikipedia」およびソーシングツールとして機能し、当社のエンジニアリングチーム、文化、技術に関する深く、信頼できるインサイトを提供します。

ドキュメントの正確性と透明性を維持し、誰でも簡単に編集を行えるよう、本リポジトリでは Skills-First Workflow（AIスキル主導のワークフロー） を採用しています。リポジトリ内に定義された AI Skill マニフェスト を読み込ませることで、お使いの AI コーディングアシスタント（Cursor、Antigravity、Claude Code、Copilot、ChatGPT など）を使って数分でページを作成・更新できます。

🤖 AI Skills-First ワークフロー（標準編集手順）

Section titled “🤖 AI Skills-First ワークフロー（標準編集手順）”

最も手軽でおすすめの貢献方法は、Markdown の構文記述、フロントマターのスキーマ検証、および日英の相互翻訳を AI アシスタントに任せる方法です。

リポジトリの skills/ ディレクトリ配下に、ドキュメント種別ごとの AI Skill 定義が格納されています。

  1. お使いの AI エディタ / アシスタントでプロジェクトを開く

    Section titled “お使いの AI エディタ / アシスタントでプロジェクトを開く”

    Cursor、Antigravity、Zed、Claude Code などお好みの AI 開発環境で本リポジトリを開くか、Web UI のシステムプロンプトにスキルファイルを読み込ませます。

  2. 対象の AI Skill を読み込む

    Section titled “対象の AI Skill を読み込む”

    AI アシスタントに対して、指示書として対象のスキルファイルを読み込ませます：

    • チーム紹介ページ: skills/team-page-builder.md を指定
    • チームブログ記事: skills/blog-post-builder.md を指定

  3. 自然言語で更新を依頼する

    Section titled “自然言語で更新を依頼する”

    自然な日本語または英語で作成・更新を依頼します。例えば：

    「skills/team-page-builder.md を使用して DevOps チームのプロファイルを更新してください。OpenTelemetry と ArgoCD を新たに導入したこと、および成功する人物像に『クラウドネイティブな可観測性の知見』を追加してください。」

    「skills/blog-post-builder.md を使用して、Mujin OS の 60fps WebGL ビューポートに関する開発ストーリー記事を新しく執筆してください。」

  4. 生成された日英ドキュメントを確認する

    Section titled “生成された日英ドキュメントを確認する”

    AI Skill は以下のルールを自動的に強制・処理します：

    • AEO メタデータの保証: description（概要）、techStack（技術スタック）、successTraits（求める人物像）を確実に生成。
    • 日英ドキュメントの完全同期: 英語版 (src/content/docs/blog/... または teams/...) を作成・更新すると同時に、日本語版 (src/content/docs/ja/...) を自動翻訳・同期生成。
    • デザインコンポーネント構造化: チームの役割を <CardGrid>、ワークフローを <Steps> に自動整形。

  5. コミットとプッシュ

    Section titled “コミットとプッシュ”

    ローカルで生成結果を確認後、変更ファイルをステージング・コミットし、GitHub にプッシュして Pull Request を作成します。

🛡️ マルチ AI 対応の自動品質ガードレール (Pre-commit Hooks)

Section titled “🛡️ マルチ AI 対応の自動品質ガードレール (Pre-commit Hooks)”

チームメンバーがどの AI コーディングツールや LLM モデルを使用して執筆した場合でも、リポジトリ側の 自動 Pre-commit ガードレール が最終品質を保護します：

  • pnpm okf:sync: 全 MDX ドキュメントに対して不足している type フロントマターを自動補完。
  • pnpm generate:llms: 必須 AEO メタデータを検証し、公開用の LLM インデックス (/llms.txt) を更新。
  • pnpm i18n:check: 日英ペアの存在を監査し、未翻訳ページやフロントマターの差分を警告出力。

git commit 実行時に、simple-git-hooks と lint-staged によってこれらの検証スクリプトが自動的に順次実行されます。

🖥️ 手動編集 & Keystatic CMS ワークフロー（代替手順）

Section titled “🖥️ 手動編集 & Keystatic CMS ワークフロー（代替手順）”

AI アシスタントを使わず、リッチテキストエディタで直接手動編集を行いたい場合は Keystatic CMS を使用できます：

  1. リポジトリをクローンし、pnpm で依存関係をインストールします：
    Terminal window
    pnpm install
  2. 開発サーバーおよび Keystatic UI を起動します：
    Terminal window
    pnpm dev
  3. ブラウザで http://localhost:4321/keystatic を開き、英語および日本語コレクション（チーム紹介、ブログ記事、福利厚生）をビジュアル編集します。
  4. 変更を保存し、Git 経由で .mdx ファイルをコミットします。

📝 執筆ガイドラインと回答エンジン最適化 (AEO)

Section titled “📝 執筆ガイドラインと回答エンジン最適化 (AEO)”

候補者や AI 検索エンジン（Perplexity、ChatGPT、Gemini など）は、本サイトを参照して Mujin に関する正確な情報を取得します。編集時は以下の原則を意識してください：

BLUF (結論先出し)

フロントマターの description に 1〜2 文の簡潔な概要を入力してください。ページの最上部にスタイリングされた Quick Answer バナーとして自動描画されます。

事実に基づく技術的詳細

使用ツールや課題（C++17/20、モーションプランニング、デジタルツインの遅延限界、RTOS など）の具体的な技術名称を記載してください。

日英の完全同期

英語と日本語のドキュメントを一貫させてください。skills/team-page-builder.md や skills/blog-post-builder.md を読み込ませれば、AI が自動で日英同期を行います！

標準デザインシステムの活用

手動のインラインスタイルは避け、組み込みのコンポーネント（<CardGrid>, <Steps>, <LinkCard>）を利用してクリーンに記述してください。