pasta-lua-coding

name: pasta-lua-coding description: >- pasta.dll Luaランタイム APIリファレンスとコーディング規約。 ゴーストの scripts/ 配下のカスタムLuaスクリプトや、 Pasta DSL内のLuaブロック実装を支援する。 USE FOR: pasta lua, pasta_lua, Lua API, Luaスクリプト, scripts/, pasta_scripts/, 単語辞書一括投入, WORD.create, イベントハンドラ, REG, RES, 永続化, @pasta_persistence, save, @pasta_search, @pasta_config, @pasta_sakura_script, @enc, @pasta_log, ロギング, logging, log, trace, debug, info, warn, error, ACT, SCENE, STORE, GLOBAL, SAVE, lua_test, luacheck, mocks, lua_test.mocks, モックライブラリ, mock install, mock reset, pasta lua coding, pasta runtime API. DO NOT USE FOR: Pasta DSL文法, .pastaファイル編集, pasta_dsl crate, pasta_core crate, Rustクレート実装, 汎用Luaプログラミング, SHIORIプロトコル実装. metadata: author: ekicyou version: "1.8.0"

Pasta Lua Coding Skill

§1 Purpose & Prerequisites

目的: 自然言語の指示からpasta_luaランタイムに準拠したLuaコードを正確に生成するサポートを提供する。

対象ドメイン:

• scripts/ 配下のカスタムLuaスクリプト（main.lua がエントリーポイント、pasta_scripts/ より優先）
• pasta_scripts/ 配下の標準ランタイムスクリプト（エンジン同梱）
• Pasta DSL内の ```lua ``` ブロックで記述するシーン関数

前提条件: ゴーストプロジェクトが既に存在すること（pasta.toml、dic/、pasta_scripts/ が揃っている）。

役割分離: 姉妹スキル pasta-ghost-authoring がPasta DSL文法（.pastaファイルの記述）を担当し、本スキルはその下位層であるLuaランタイム層を担当する。DSLの ```lua ``` ブロック内のコード記述や、scripts/ 配下のカスタムスクリプト・pasta_scripts/ 配下のランタイムスクリプト開発を支援する。

scripts/ フォルダ: ゴーストディレクトリ直下の scripts/ にユーザーカスタムLuaスクリプトを配置する。main.lua がエントリーポイントとしてpastaランタイムに読み込まれ、シーン関数・単語定義・イベントハンドラ等をセットアップする。scripts/ は pasta_scripts/ より優先されるため、同名ファイルでランタイムの動作を上書きできる。

DSL vs Lua 判断基準

自己完結性: 本スキルは別リポジトリにコピーして単体で機能する。pastaリポジトリ内の他ファイルへの参照に依存しない。

詳細リファレンス: references/ 配下に完全なAPIリファレンスとコーディング規約を配置。必要に応じて read_file でロードする。

§2 Quick Reference

Rust組み込みモジュール

内部Luaモジュール（pasta.*名前空間）

mlua-stdlib統合モジュール

DSL→Luaブリッジ基本形

-- DSL内 ```lua ブロックから呼ばれるシーン関数の定型
function SCENE.func_name(act)
    local save, var = act:init_scene(SCENE)  -- 必須: save/var を取得
    act:talk(act.さくら.actor, "セリフ")    -- アクター名でトーク
    act:yield()                               -- トークンをyield
end

§3 Coding Conventions

命名規約（snake_case/UPPER_CASE/_IMPLサフィックス）、MODULE/MODULE_IMPL分離によるクラス設計、STOREパターンによる循環参照回避、EmmyLua型注釈（@class, @field, @param, @return）、エラーハンドリング（ガードクローズ, pcall, nilチェック）の規約。

📖 詳細: references/coding-conventions.md

SAVE キー命名規約

pasta.save テーブルのキーは以下の2種類に分類される：

重要: pasta_ プレフィックスはエンジン予約領域。ゴースト固有キーに pasta_ を使用すると、エンジン動作に意図しない影響を与える可能性がある。

§4 Runtime API

Rust組み込みモジュールの完全APIリファレンス。@pasta_search（シーン・単語検索、フォールバック戦略）、@pasta_persistence（セーブデータ永続化）、@pasta_config（pcall必須）、@pasta_sakura_script（ウェイトタグ変換）、@enc（UTF-8⇔ANSI）、@pasta_log（ロギング、trace/debug/info/warn/error）。mlua-stdlib（@json, @yaml, @regex等）も含む。

📖 詳細: references/runtime-api.md

§5 Internal Modules

pasta.*名前空間の内部Luaモジュール。STORE（一元データ管理）、ACT（シーン実行コンテキスト、init_scene/talk/yield等）、SCENE（シーン登録・検索・コルーチン実行）、WORD（ビルダーパターン単語定義）、GLOBAL（ユーザー定義関数）、SAVE（永続化データ）、finalize_scene（検索インデックス構築）。

📖 詳細: references/internal-modules.md

§6 SHIORI Handlers

SHIORIイベントハンドラの登録と応答。REGテーブルにイベントハンドラを登録し、RES.ok()/RES.no_content()等でレスポンスを返す。主要イベント（OnBoot, OnClose, OnMouseDoubleClick, OnChoiceSelectEx等）のreference[N]仕様。OnTalk/OnHourを自動発行する仮想ディスパッチャ。OnChoiceSelectEx選択肢自動ルーティング。REG未登録時のシーン検索フォールバックチェーン。

📖 詳細: references/shiori-handlers.md

§7 Testing & Lint

BDD風テストフレームワーク lua_test（describe/test/expectマッチャー）。テストファイル規約（*_test.lua命名、init.lua登録）。set_scene_selector/set_word_selectorによる決定論的テスト。luacheck設定と実行方法。

📖 詳細: references/testing-lint.md

References

本スキルの詳細リファレンス。必要に応じて read_file でロードすること。