Appearance
作業記録 Wiki — チーム共有資料
社内の作業記録を Wiki 化するプロジェクトについての説明資料です。
これは何？
Notion に書いてた日々の作業記録を、検索しやすい Wiki サイトにしたもの です。
🔗 https://xseeds-wiki.pages.dev
なぜ作ったのか
Before（課題）
Notion の作業記録
├── 松崎/LKG研修用のパズルゲームを作ってみる.md
├── 松崎/LKG研修用のパズルゲームを作ってみる。２.md ← 続編がバラバラ
├── 松崎/LKG用ゲーム.md ← 似た内容が別ファイル
├── 松崎/LKG用ゲーム制作.md ← さらに別ファイル
├── 村井/無題.md ← タイトルなし
├── 水上/LKG キルト：再生アプリ.md
├── 水上/LKG キルト：再生アプリ２.md ← 連番で追跡困難
├── 水上/LKG キルト：再生アプリ3.md
└── ...39ファイルが人・日付ベースで散在- 「あの情報どこだっけ？」が頻発
- 同じ内容が複数ファイルに散在
- 日次の作業メモなので、結論だけ知りたい人には読みにくい
- 著者以外には背景知識がなく理解しづらい
After（Wiki）
Wiki（テーマ別に統合）
├── lkg-入門.md ← 新規：まず読む入門記事
├── lkgsdk-導入・パフォーマンスガイド.md ← 4ファイル → 1記事に統合
├── lkg-パズルゲーム開発.md ← 4ファイル → 1記事に統合
├── キルト再生アプリ開発.md ← 3ファイル → 1記事に統合
├── 断面表示シェーダー比較.md ← 8ファイル → 1記事に統合
└── ...全15記事、カテゴリ別に整理- テーマ別に 1 記事で完結
- AI が背景知識を補足（:::tip AI補完）
- 全文検索可能
- URL を共有するだけで誰でも読める
数字で見る成果
| Before | After | |
|---|---|---|
| LKG 記事数 | 39 本（日次ログ） | 15 本（テーマ別） |
| 検索 | Notion 内検索のみ | 全文検索付き Web サイト |
| アクセス | Notion アカウント必要 | URL で即アクセス |
| 更新の見える化 | なし | Git 履歴で差分が見える |
| ホスティング費用 | ― | 0 円 |
技術構成（ざっくり）
┌─────────────┐ ┌──────────────┐ ┌───────────────────┐
│ Notion │────→│ Markdown │────→│ VitePress │
│ （作業記録） │ 変換 │ ファイル │ ビルド │ （静的サイト生成） │
└─────────────┘ └──────────────┘ └────────┬──────────┘
│
┌──────────────┐ ┌────────▼──────────┐
│ GitHub │────→│ Cloudflare Pages │
│ （ソース管理） │ 自動 │ （ホスティング） │
└──────────────┘ デプロイ └───────────────────┘各技術の役割
| 技術 | 何をしてるか | 初学者向け説明 |
|---|---|---|
| Markdown | 記事のフォーマット | テキストに # や **太字** で書式をつける書き方 |
| VitePress | サイト生成 | Markdown を HTML に変換してくれるツール |
| GitHub | ソースコード管理 | ファイルの変更履歴を全部記録してくれる |
| GitHub Actions | 自動デプロイ | GitHub に push したら自動でサイト更新 |
| Cloudflare Pages | ホスティング | 作ったサイトをインターネットに公開してくれる |
| Git LFS | 大容量ファイル管理 | 画像ファイル（4,000 枚）を効率的に保存 |
記事の構成（LKG カテゴリの例）
各記事はこんな構成になっています：
markdown
---
title: "LKGSDK 導入・パフォーマンスガイド" ← メタ情報
author: "松崎"
category: "lkg"
ai_enhanced: true ← AI が加筆した印
---
# LKGSDK 導入・パフォーマンスガイド ← タイトル
## 概要 ← まず何の話かわかる
SDK の導入手順とパフォーマンス検証結果です...
## セットアップ手順 ← 具体的な手順
1. Unity Hub を開きます...
::: tip AI補完 ← AI が追加した補足
SDK3 と SDK4 の違いを整理すると... ← 原著者が書かなかった背景知識
:::
## ベンチマーク結果 ← 元の作業記録から抽出した成果
| SDK3 | SDK4 |
| 64fps | 198fps |ポイント：
AI補完ブロックは AI が追加した内容。元の作業記録にはなかった背景知識や技術解説- 元の著者の実験結果・数値・スクリーンショットはそのまま保持
ai_enhanced: trueがついている記事は AI 加筆済みの印
現在のカテゴリ一覧
| カテゴリ | 記事数 | 整理状況 |
|---|---|---|
| Looking Glass (LKG) | 15 | ✅ 整理済み |
| AR/VR 開発 | 62 | ⬜ 未整理（日次ログのまま） |
| プロジェクト・展示会 | 44 | ⬜ 未整理 |
| 音声合成・AITuber | 16 | ⬜ 未整理 |
| AI 生成ツール | 12 | ⬜ 未整理 |
| 3D モデリング・CAD | 10 | ⬜ 未整理 |
| 深度推定 | 8 | ⬜ 未整理 |
| 医療系 3D | 5 | ⬜ 未整理 |
| 環境構築ガイド | 3 | ⬜ 未整理 |
| その他 | 3 | ⬜ 未整理 |
更新のしかた
今の運用（シンプル版）
1. 記事を書く・編集する（Markdown）
2. git add → git commit → git push
3. 自動でサイトに反映（約 2 分）もうちょっと詳しく
bash
# 1. リポジトリをクローン（初回のみ）
git clone https://github.com/xseeds/Wiki.git
cd Wiki
# 2. 記事を編集
# docs/lkg/lkg-入門.md などを直接編集
# 3. ローカルで確認（任意）
npm ci # 初回のみ
npm run docs:dev # http://localhost:5173 で確認
# 4. push して反映
git add docs/lkg/lkg-入門.md
git commit -m "LKG入門の手順を更新"
git push
# → 自動でビルド＆デプロイされるよくある質問
Q. Notion はもう使わないの？
A. Notion はこれまで通り使います。 日々の作業記録は Notion に書いてOKです。Wiki は「まとまった知見」を共有する場所です。将来的には Notion → Wiki の自動同期も検討しています。
Q. 自分の記事を修正したいんだけど
A. Markdown ファイルを編集して push すれば反映されます。Git の使い方がわからなければ、修正内容を伝えてもらえれば代わりに更新します。
Q. AI 補完の内容が間違ってたら？
A. 修正してください！ :::tip AI補完 ブロックの中身を書き換えて push すれば OK です。AI の補足はあくまで参考情報です。
Q. 新しい記事を追加したい
A. 該当カテゴリのフォルダに .md ファイルを追加して push するだけです。サイドバーは自動生成されるので、特別な設定は不要です。
Q. 画像を追加したい
A. docs/public/assets/{カテゴリ名}/ に画像を置き、記事中で <img src="/assets/{カテゴリ名}/ファイル名.png"> と参照します。
今後の予定
- 残り 9 カテゴリの整理（AR/VR、プロジェクト等）
- 記事レビュー体制の構築（AI 補完内容の正確性確認）
- アクセス制限の追加（社外からのアクセスを制限）
- 検索機能の改善（日本語検索の精度向上）
リンク集
| リソース | URL |
|---|---|
| Wiki サイト | https://xseeds-wiki.pages.dev |
| GitHub リポジトリ | https://github.com/xseeds/Wiki |
| Cloudflare ダッシュボード | https://dash.cloudflare.com |