StudyUnity 🎮 — Unity を学ぶ記録

Unity を学んだことを書きためる勉強ログ。技術ブログ寄りで、ちょっと遊び心も。 Astro 製の静的サイトで、記事は Markdown で管理する。

~/study/unity $ unity -projectPath .

開発

npm install        # 初回のみ
npm run dev        # http://localhost:4321/StudyUnity/ でプレビュー（ホットリロード）
npm run build      # 本番ビルド → dist/
npm run preview    # ビルド結果をローカル確認
npm run check      # 型 + content schema の検証

必要環境: Node.js 18+（開発は Node 26 で確認）。 base パス（/StudyUnity）を設定しているため、ローカルでも URL は /StudyUnity/ 始まりになる。

記事を書く

1. src/content/posts/<slug>.md を作る（1記事=1ファイル）。
2. frontmatter を付ける（必須: title / date / summary、任意: tags / level / draft）。

---
title: "MonoBehaviour のライフサイクルではじめる Unity"
date: 2026-06-18
summary: "Awake / Start / Update など、毎フレーム呼ばれるイベント関数の基本。"
tags: ["スクリプティング", "基礎"]
level: beginner   # beginner | intermediate | advanced
---

本文（Markdown）...

Notion のメモから起こす場合は、Claude Code で /new-log を使うと整形して追加できる。 書き方の詳細は .claude/rules/content.md。

プロジェクト構成

src/
  content/posts/   記事(Markdown)。1記事=1ファイル
  content.config.ts frontmatter スキーマ（型の真実源）
  pages/           ルーティング（一覧 / 記事 / タグ / about / 404）
  layouts/         Base / Post レイアウト
  components/      Header / Footer / PostCard
  styles/global.css 配色・デザイン（Unity を連想させる purple #7C5CFF が基調）
  site.ts          サイト設定（タイトル・ナビ・文言）
docs/              知識の置き場所（SoT 表・意思決定ログ・ハーネス解説）
.claude/           開発ハーネス（hooks / rules / skills / settings）
scripts/           decisions 索引の生成

デプロイ（GitHub Pages）

main に push すると GitHub Actions（.github/workflows/deploy.yml）が自動でビルド・公開する。

• 公開URL: https://kkmia417.github.io/StudyUnity/
• 初回のみ GitHub の Settings → Pages → Build and deployment → Source を 「GitHub Actions」 にする（CLI から有効化済みなら設定不要）。
• 公開URLが変わる場合（独自ドメイン等）は astro.config.mjs の site / base を更新する。 独自ドメインをルートで使うなら base を "/" に戻す。

内部リンクは base を意識しなくてよい。コンポーネントは withBase()（src/site.ts）、 Markdown 本文の /posts/... は rehype プラグインが自動で base を前置する。

開発環境について

このリポは「AIエージェント・ハーネスエンジニアリング」の原則を個人運用向けに簡略化して 取り入れている（必読の場所へルールをインライン＋hookで裏打ち、知識は1か所に薄く）。 仕組みは docs/dev-environment/harness.md を参照。