luau-core

luau-core

使用する場面

主に純粋な Luau 言語の動作に関するタスクでは、このスキルを使用してください。

• 純粋な Luau の構文を記述または修正する。
• 慣用的な制御フロー、変数のスコープ、関数の構成を選ぶ。
• 配列、辞書、オブジェクトのような値としてテーブルを扱う。
• 標準ライブラリを正しく使用する。
• インデックス、演算子、反復、オブジェクトのようなパターンにメタテーブルを適用する。
• Lua の機能や慣用表現が Luau と互換性があるか確認する。

主に次の内容に関するタスクでは、このスキルを使用しないでください。

• Luau の型注釈、ジェネリクス、型推論、型の絞り込み、厳格性の方針。
• プロファイリング、最適化戦略、パフォーマンス上のトレードオフ。
• Roblox エンジンの API、サービス、イベント、クラス、ネットワーク、データ、ゲームプレイのアーキテクチャ。

判断基準

• 純粋な Luau の構文、セマンティクス、慣用表現、標準ライブラリの使用法だけで回答できる場合は、このスキルを使用してください。
• タスクの中心が型エイリアス、注釈、ジェネリクス、エクスポートされた型、アナライザーの動作である場合は、luau-types に引き継いでください。
• タスクの中心がメモリ割り当てのパターン、ホットループ、ベンチマーク、プロファイリング、最適化戦略である場合は、luau-performance に引き継いでください。
• タスクが game、Instance、サービス、リモート、データストア、UI、物理演算、その他の Roblox ランタイムの概念に依存する場合は、適切な roblox/* スキルを使用してください。
• 依頼にコア言語の作業と対象外のトピックが混在している場合は、純粋な Luau の部分だけに回答し、残りは明示的に対象外としてください。
• 判断に迷った場合は、狭く解釈し、ほかのスキルと重なる可能性のある内容は省いてください。

指示

1. Luau は Lua 5.1 に一部の Luau 拡張を加えたものとして扱ってください。Luau が明示的にサポートしていない限り、Lua 5.2 以降の機能を想定しないでください。
2. 既定では local 変数と local function 宣言を優先してください。より広いスコープがタスクで必要な場合に限り、グローバル変数を使用してください。
3. 制御フローは直接的にしてください。巧妙なブール値のトリックより、通常の if、elseif、else、ループ、break、continue を優先してください。
4. 正確性や可読性が向上する場合は、Luau 固有の構文を使用してください。
   • a and b or c による三項演算子の模倣ではなく、if ... then ... else ... 式を使用する。
   • 左辺が一度だけ評価されるべき場合は、+= などの複合代入を使用する。
   • テーブルを直接反復する場合、それが最も明確な形式であれば、一般化された反復 for k, v in table do を使用する。
5. テーブルは意図を明確にして使い分けてください。
   • 順序付きの数値シーケンスには配列を使用する。
   • キーによる検索には辞書を使用する。
   • カスタムの動作によって API が大きく改善される場合に限り、メタテーブルを使ったレコードを使用する。
6. self を概念的に渡すメソッドの定義と呼び出しには : を使用し、通常の関数アクセスには . を使用してください。
7. 標準ライブラリで処理を明確に表現できる場合は、自作のヘルパーより組み込みライブラリ関数を優先してください。
8. メタテーブルは控えめかつ明示的に使用してください。抽象化に必要なメタメソッドだけを定義し、予想外の動作を避けてください。
9. 互換性について説明するときは、goto、ビット演算子、整数だけを前提とした考え方、Lua 標準ライブラリ全体へのアクセスなど、サポートされない前提を早い段階で指摘してください。
10. すべての例はホスト環境に依存しない純粋な Luau にしてください。Roblox エンジンのオブジェクトやサービスに依存しないでください。

リファレンスの利用

• 構文形式、リテラル、代入、式の形式、Luau 固有の構文の追加については、references/getting-started-and-syntax.md を開いてください。
• 関数、クロージャ、テーブル、真偽値の判定、反復、制御フローといった実行モデルの基本については、references/functions-tables-operators-scope-and-control-structures.md を開いてください。
• メタメソッドの動作、オブジェクトのようなテーブルのパターン、raw 操作、userdata の境界については、references/metatables-and-userdata-concepts.md を開いてください。
• 標準ライブラリの選択と、文や式に関する簡潔な文法の確認には、references/library-and-grammar-reference.md を開いてください。
• Luau と Lua を比較するリクエストや、バージョン固有の動作に関するリクエストでは、references/compatibility-notes.md を開いてください。
• タスクが明らかに別のスキルの範囲にも関係する場合を除き、このスキル以外のリファレンスは開いたり引用したりしないでください。

チェックリスト

• 解決策の構文が有効な Luau です。
• スコープが明示され、デフォルトで local になっています。
• 制御フローが明確で、正しい構成のうち最も簡潔なものを使っています。
• テーブルの使い方が意図的です。配列、辞書、またはメタテーブルを使ったレコードのいずれかです。
• データの形状に適した反復方法を選んでいます。
• 標準ライブラリの使い方が正しく、カスタムヘルパーより簡潔です。
• メタテーブルの動作は最小限で予測可能です。また、分かりにくい場合はコード内で説明されています。
• 型システムに関する高度な内容は含まれていません。
• パフォーマンス調整に関するガイダンスは含まれていません。
• Roblox エンジンの API やアーキテクチャに関するアドバイスは含まれていません。

よくある間違い

• 0 や "" を偽とみなすこと。Luau では false と nil だけが偽です。
• b が false または nil になり得る場合に、三項演算子の代わりとして a and b or c を使うこと。
• 配列のインデックスが 0 から始まると思い込むこと。Luau では 1 から始まります。
• : で定義して . で呼び出すなど、メソッド構文と関数構文を混在させること。
• 辞書の反復順序に依存すること。
• 関数の引数が不足すると nil になり、余分な引数は無視されることを忘れること。
• ローカル変数やクロージャが適切な場面で、グローバル変数を使うこと。
• 単純なデータコンテナーにメタテーブルを過剰に使うこと。
• goto、ビット演算子、整数の意味論など、新しい Lua の機能が Luau にも存在すると考えること。

例

真偽値を使った三項演算子風の処理ではなく、if 式を使う

local function labelScore(score)
    return if score >= 100 then "high" else "normal"
end

ローカル変数と分かりやすい制御フローを優先する

local function firstPositive(values)
    for _, value in values do
        if value > 0 then
            return value
        end
    end

    return nil
end

テーブルを意図的に使う

local queue = {}

queue[#queue + 1] = "a"
queue[#queue + 1] = "b"

local first = table.remove(queue, 1)

オブジェクトのようなテーブルにはメソッド構文を使う

local Counter = {}
Counter.__index = Counter

function Counter.new()
    return setmetatable({ value = 0 }, Counter)
end

function Counter:increment()
    self.value += 1
    return self.value
end

動作を意図する場合にのみメタテーブルを追加する

local Range = {}
Range.__index = Range

function Range.new(minimum, maximum)
    return setmetatable({ minimum = minimum, maximum = maximum }, Range)
end

function Range:contains(value)
    return value >= self.minimum and value <= self.maximum
end

function Range:__tostring()
    return string.format("[%d, %d]", self.minimum, self.maximum)
end