unity-script

Create, read and analyze C# scripts

不碰外部（只输出文字）无严重或高危命中Besty0728/Unity-Skills

它会碰到什么

扫了多少1 个文本文件，13 KB

它会碰到什么不碰外部（只输出文字）

命中总数0 处

命中统计严重 0 · 高 0 · 中 0 · 低 0

这一栏是扫描器报的事实，不是结论。命中多不等于有毒（安全工具、规则库、示例脚本本来就会包含危险写法），命中少也不等于干净。它和你手上的凭据、文件、网络有什么关系，需要你自己看。

技能内容

> Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

Authoring or editing C# code
Searching across scripts
Refactoring file layout
Checking compile errors
编写或编辑 C# 代码、跨脚本搜索、重构文件布局、检查编译错误

Unity Script Skills

> BATCH-FIRST: Use script_create_batch when creating 2+ scripts.

> DESIGN-FIRST: Before creating gameplay scripts, actively consider coupling, performance, and maintainability. In an existing project, load ../project-scout/SKILL.md first. If the user is asking for architecture or refactoring advice, load ../architecture/SKILL.md and then ../patterns/SKILL.md, ../async/SKILL.md, ../inspector/SKILL.md, ../performance/SKILL.md, ../script-roles/SKILL.md, ../scene-contracts/SKILL.md, ../testability/SKILL.md, or ../scriptdesign/SKILL.md as needed.

Operating Mode

Approval: 只读类 skill（script_read / script_list / script_find_in_file / script_get_info / script_get_compile_feedback，标 SkillMode.SemiAuto）直接执行；本模块没有可 grant 的写型 skill —— 每一个写型 skill 都命中下一条的自动拦截，grant 只会再返一次 MODE_FORBIDDEN。
Auto / Bypass: SemiAuto 与（Bypass 下的）写型 skill 直接执行。
本模块全部 7 个写型 skill 都是 Delete / Reload 类高危：script_create / script_create_batch / script_replace / script_append / script_rename / script_move / script_delete 均标 MayTriggerReload = true + RiskLevel = "high"（落盘 .cs 必然触发 Domain Reload），script_delete 另标 SkillOperation.Delete —— 这些 skill 被 IsForbiddenInSemi 静态拦截，在 Approval 和 Auto 下都返 MODE_FORBIDDEN，仅 Bypass 或 Allowlist 命中可执行，不要尝试 grant 流程。

DO NOT (common hallucinations):

script_edit / script_update do not exist → use script_replace for find-and-replace
script_write does not exist → use script_create (new file) or script_replace (modify existing)
scriptName parameter must NOT include .cs extension
Templates only accept: MonoBehaviour, ScriptableObject, Editor, EditorWindow

Routing:

To modify existing script content → script_replace (find/replace) or script_append (add lines)
To read script → script_read
To check compile errors → script_get_compile_feedback
To analyze script API → use perception module's script_analyze

Skills Overview

| Single Object | Batch Version | Use Batch When |

|---------------|---------------|----------------|

| script_create | script_create_batch | Creating 2+ scripts |

No batch needed:

script_read - Read script content
script_list - List C# script files under a folder
script_get_info - Read class name, base class, public methods/fields
script_delete - Delete script
script_find_in_file - Search in scripts
script_append - Append content to script
script_replace - Find and replace inside one script (plain text or regex)
script_rename - Rename a script file in place
script_move - Move a script to another folder; a missing destination folder is created automatically
script_get_compile_feedback - Check compile errors for one script after Unity finishes compiling
create_script() in scripts/unity_skills.py now waits for Unity to come back once and refreshes compile feedback automatically after script creation.

Skills

script_create

Create a C# script from template.

|-----------|------|----------|---------|-------------|

| diagnosticLimit | int | No | 20 | Max compile diagnostics |

Templates: MonoBehaviour, ScriptableObject, Editor, EditorWindow

Returns: {success, status, path, jobId, className, namespaceName, designReminder, serverAvailability?}

Poll the returned jobId (or call script_get_compile_feedback) to obtain compile diagnostics — they are not embedded in the synchronous response. serverAvailability carries the transient-unavailable hint when Unity is about to reload the script domain.

script_create_batch

Create multiple scripts in one call.

Returns: {success, totalItems, successCount, failCount, results: [{success, path, className}], compilation?}

Before batch creation, decide whether each script should be:

a thin MonoBehaviour bridge
a ScriptableObject configuration asset
or a plain C# domain/service class generated from a custom template

unity_skills.call_skill("script_create_batch", items=[
    {"scriptName": "PlayerController", "folder": "Assets/Scripts/Player", "template": "MonoBehaviour"},
    {"scriptName": "EnemyAI", "folder": "Assets/Scripts/Enemy", "template": "MonoBehaviour"},
    {"scriptName": "GameSettings", "folder": "Assets/Scripts/Data", "template": "ScriptableObject"}
])

script_read

Read script content.

|-----------|------|----------|-------------|

Returns: {path, lines, content}

script_delete

Delete a script.

|-----------|------|----------|-------------|

Returns: {success, status, deleted, jobId, serverAvailability?}

script_find_in_file

Search for patterns in scripts.

|-----------|------|----------|---------|-------------|

| limit | int | No | 50 | Max results |

Returns: {pattern, matchCount, matches: [{file, line, content}]}

script_append

Append content to a script.

|-----------|------|----------|---------|-------------|

| atLine | int | No | end | Line number to insert at |

| diagnosticLimit | int | No | 20 | Max compile diagnostics |

script_get_compile_feedback

Get compile diagnostics related to one script.

|-----------|------|----------|---------|-------------|

| limit | int | No | 20 | Max diagnostics |

Example: Efficient Script Setup

import unity_skills

# BAD: 3 API calls + 3 Domain Reloads
unity_skills.call_skill("script_create", scriptName="PlayerController", folder="Assets/Scripts/Player")
# Wait for Domain Reload...
unity_skills.call_skill("script_create", scriptName="EnemyAI", folder="Assets/Scripts/Enemy")
# Wait for Domain Reload...
unity_skills.call_skill("script_create", scriptName="GameManager", folder="Assets/Scripts/Core")
# Wait for Domain Reload...

# GOOD: 1 API call + 1 Domain Reload
unity_skills.call_skill("script_create_batch", items=[
    {"scriptName": "PlayerController", "folder": "Assets/Scripts/Player"},
    {"scriptName": "EnemyAI", "folder": "Assets/Scripts/Enemy"},
    {"scriptName": "GameManager", "folder": "Assets/Scripts/Core"}
])
# Wait for Domain Reload once...

Important: Domain Reload And Compile Feedback

After creating or editing scripts, Unity triggers a Domain Reload (recompilation). Use the returned compilation field first. If isCompiling=true, wait for Unity to finish and then call script_get_compile_feedback.

import time

result = unity_skills.call_skill("script_create", scriptName="MyScript")
time.sleep(5)  # Wait for Unity to recompile if result["compilation"]["isCompiling"] is true
feedback = unity_skills.call_skill("script_get_compile_feedback", scriptPath=result["path"])
unity_skills.call_skill("component_add", name="Player", componentType="MyScript")

Best Practices

Use meaningful script names matching class name
Organize scripts in logical folders
Before creating gameplay code, decide the class role first: MonoBehaviour, ScriptableObject, or plain C# helper/service
Actively reduce coupling: prefer explicit dependencies, small responsibilities, and event-driven notifications over hidden globals
Actively consider performance: avoid unnecessary Update, repeated Find, reflection in hot paths, and avoidable allocations
Actively consider maintainability: clear naming, explicit ownership, Inspector-friendly fields, and simple module boundaries
Avoid giant boilerplate/template dumps. Start from the smallest structure that solves the current need
Do not default to UniTask or a global event bus unless the project context justifies them
Avoid cryptic abbreviations in class, field, and method names unless they are already a project convention
Use templates for correct base class
Wait for compilation after creating scripts
After script edits, call script_get_compile_feedback and fix reported errors
Use regex search for complex patterns
Use batch creation to minimize Domain Reloads

Additional Skills

`script_replace`

Find and replace content in a script file.

|-----------|------|----------|---------|-------------|

| diagnosticLimit | int | No | 20 | Max compile diagnostics |

Returns: { success, status, path, jobId, replacements, serverAvailability? }

`script_list`

List C# script files in the project.

|-----------|------|----------|---------|-------------|

| limit | int | No | 100 | Max results |

Returns: { count, scripts: [{ path, name }] }

`script_get_info`

Get script info (class name, base class, methods).

|-----------|------|----------|---------|-------------|

Returns: { path, className, baseClass, namespaceName, isMonoBehaviour, publicMethods, publicFields }

`script_rename`

Rename a script file.

|-----------|------|----------|---------|-------------|

| diagnosticLimit | int | No | 20 | Max compile diagnostics |

Returns: { success, status, path, jobId, oldPath, newName, serverAvailability? }

`script_move`

Move a script to a new folder.

|-----------|------|----------|---------|-------------|

| diagnosticLimit | int | No | 20 | Max compile diagnostics |

Returns: { success, status, path, jobId, oldPath, newPath, serverAvailability? }

Exact Signatures

Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.

Common Errors

Full transport-level codes (COMPILING/RATE_LIMIT etc.) → ../../references/protocol-error-codes.md

| Error | Trigger | Fix |

|---|---|---|

| MISSING_PARAM | A required parameter is missing, such as scriptName in script_create or pattern in script_find_in_file. | Supply the parameter named in the error; use mode=dryRun to see the schema. |

| SEMANTIC_INVALID | The input violates a naming/path rule, such as scriptName must not contain path separators, newName must not contain path separators, or the script already exists. | Remove path separators, choose a unique name, or rename/move the existing file first. |

| TARGET_NOT_FOUND | The script file, MonoScript, or target directory could not be found. | Verify the path with asset_find or script_list, then retry with the correct scriptPath. |

| SKILL_ERROR | A filesystem operation failed, such as Failed to delete script or an AssetDatabase move/rename error. | Read the error details, resolve the underlying file/AssetDatabase issue, and retry. |

想直接用这个技能？

本站把开放许可（MIT / Apache 等）的技能按仓库打包整理到网盘，点一下转存到你自己的网盘，不用一个个从 GitHub 拉。许可未声明的技能只给原始仓库链接，不打包。

去原始仓库

它属于哪个仓库

仓库Besty0728/Unity-Skills

星标★ 1,753

本站分层T1

该仓技能数83

原文件路径SkillsForUnity/unity-skills~/skills/script/SKILL.md

同一个仓库里的其他技能

看这个仓库的全部 83 个技能