research-highrise-studio-lua-api

深入探讨 Highrise Studio Lua API 文档并回答问题。

📖 中文导读:深入探讨 Highrise Studio Lua API 文档并回答问题。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: research-highrise-studio-lua-api description: Dive into the Highrise Studio Lua API docs and answer questions.

Research the Highrise Studio Lua API

Parse and synthesize the Highrise Studio API docs, which describe the Lua API available to Highrise Studio projects. The docs are contained in YAML files cloned from a public repo. The YAML files are formatted like:

name:
type:
summary:
code_samples:
inherits:
tags:
constructors:
  - name:
    summary:
    is_static:
    code_samples:
    tags:
    parameters:
      - name:
        type:
        tags:
        default:
        summary:
    returns:
      - type:
        summary:
properties:
  - name:
    summary:
    is_static:
    code_samples:
    tags:
    type:
methods:
  - name:
    summary:
    is_static:
    code_samples:
    tags:
    parameters:
      - name:
        type:
        tags:
        default:
        summary:
    returns:
      - type:
        summary:
math_operations:
  - operation:
    summary:
    type_a:
    type_b:
    return_type:
    code_samples:
    tags:

Instructions

1. Find the Studio API docs locally

The Highrise Studio docs exist in a public repo, and should be downloaded locally to the active project under .claude/creator-docs. If not, alert the user that something has gone wrong and abort.

2. Understand the question

Identify classes and keywords that might be relevant to the incoming question. Does it refer to a specific type? Is it about a Lua script? Is it about a specific property or method?

3. Read relevant file(s)

Peruse potentially-useful YAML files in creator-docs/pages/learn/studio-api and its subfolders. Use built-in tools like Read and command-line tools like grep, ls, find, tree, etc. to discover potentially-relevant content and read files as needed.

4. Succinctly respond to the question

Synthesize the relevant files into a terse, precise answer to the incoming question. Provide summaries, parameters, return types, overloads, and code examples. Correct any misunderstandings that may be present in the question. If you cannot find an answer, tell the asker and briefly list any related topics that might be helpful to them.

Examples

Example 1: Player Position

User: "How do I get a player's position?"

  1. Check if creator-docs has already downloaded locally. If not, inform and abort.
  2. Identify relevant searches:
    • "Player"
    • "position"
  3. Search the codebase and read any relevant results, continuing to search any connected files if needed:
    • ls **/Player*.yaml
    • grep -r "position" pages/learn/studio-api
    • cat pages/learn/studio-api/classes/Character.yaml
  4. Provide a concise answer:

    Each Player object is associated with a Character. Character is a Unity component, so its position can be read via .transform.position.

    -- Assuming there is a Player instance named player
    local playerPosition = player.character.transform.position
    

Example 2: Networked Values

User: "What types of networked values are available?"

  1. Check if creator-docs has already downloaded locally. If not, inform and abort.
  2. Identify relevant searches:
    • "network*value"
    • "inherits: *Network*Value"
  3. Search the codebase and read any relevant results, continuing to search any connected files if needed:
    • grep -r "Network*Value" pages/learn/studio-api
    • grep -r "inherits" -A 1 pages/learn/studio-api | grep "Class.NetworkValue"
  4. Provide a concise answer:

    There are 9 networked value types:

    1. IntValue
    2. NumberValue
    3. StringValue
    4. BoolValue
    5. TableValue
    6. Vector2Value
    7. Vector3Value
    8. QuaternionValue
    9. NetworkObjectValue