1仕組みと動作原理

テンプレート本体に実行可能コードは含まれません。loader が src/lib/templates/skills/<id>/SKILL.md から frontmatter と本文を読み込み、本文（body）と example の内容を LoadedSkill として返します。

next/src/lib/templates/loader.ts

const raw = safeRead(path.join(dir, "SKILL.md"));

処理内容：SKILL.md が唯一の振る舞いの定義元です。frontmatter はセレクター描画用（zh_name、emoji、aspect_hint、tags、example_* など）であり、本文全体がプロンプトとなります。loader はセマンティック検証を行わず、テンプレートの記述をそのまま渡します。

配信前にホストがプロンプトを確定的に組み立てます。テンプレート本文は共有デザイン指示（SHARED_DESIGN_DIRECTIVES）と【入力形式】/【ユーザーコンテンツ】の間に挟み込まれます。

next/src/lib/templates/shared.ts

Wrap a per-template instruction body with the shared design directives and

処理内容：テンプレートは「この成果物がどのような外観を持つか」（レイアウト／リズム／コンポーネント）のみを定義し、テンプレート共通のハード制約（単一ファイル HTML、ファイルツールの使用禁止、Tailwind および Google Fonts の CDN 利用、コンテンツの信憑性、中欧文間のスペース「盤古之白」）は共有指示が担います。

共有指示はハード制約をエージェントに対する明示的な禁止事項として定義し、コンテンツ駆動による数量決定を強制します（テンプレート内の数値は参考用の下限値に過ぎません）。

next/src/lib/templates/shared.ts

**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。

同一ファイルの後続記述：出力される slide / frame / card / section の数量は、【ユーザーコンテンツ】の実際の長さと情報構造によって完全に決定されます。これにより、コンテンツが増加しても破綻せず、各段落に最低1枚のカード／セクションが割り当てられ、テンプレートはレイアウトプールのみを提供する仕組みとなっています。

実際の実行はユーザーのローカル環境に導入・ログイン済みのコーディングエージェント CLI が担います。ホストが子プロセスを spawn してプロンプトを渡し、stdout から HTML をストリーミング取得します。

next/src/lib/agents/invoke.ts

import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";

処理内容：テンプレート skill はプロンプトを提供するのみで、能力（コード記述やツールの実行を含む）はホスト CLI の既存権限に依存します。skill ディレクトリ自体にはスクリプトのエントリポイントが存在しないため、評価はディレクトリ内のアセットのみを対象とします（ホスト側の挙動は判定対象外）。

/api/convert がテンプレートの実行パスです。skill.body とユーザーコンテンツをプロンプトに組み立てた後、invokeAgent に引き渡します。

next/src/app/api/convert/route.ts

prompt = assemblePrompt({ body: skill.body, content, format });

編集モードでは別途 buildEditPrompt を経由します（差分編集を最小化し、ファイルツールを無効化、完全な HTML の直接ストリーミング出力を要求）。これにより、生成物は単一ファイル HTML、インライン CSS/SVG、フォントおよび明示的に要求されたチャートライブラリのみの外部リンクという安定した構成を維持します。

実装原理は「ナラティブアーク＋レイアウトモールド」の二重拘束です。6つの公理がコンテンツを制約し（真の問いが先、失敗の挿入が必須、命名の前にひらめきを配置など）、6つの layout class がレイアウトのリズムを制御し、いずれかを満たさない場合は再生成となります。