shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringAPI key requirement unconfirmed

unity-script

C# script management for creating, reading, and modifying Unity scripts.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

Triggers

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

Unity Script Skills

Create, edit, move and inspect C# scripts and get their compile result. Parameters come from the schema (recommend includeSchema=true or /skills/schema?names=), which notes the non-obvious ones — never from a skill's name. Execution and dryRun rules: root SKILL.md.

Operating Mode

Read-only SemiAuto skills run directly in every mode: script_read, script_list, script_find_in_file, script_get_info, script_get_compile_feedback. All 7 writers — script_create, script_create_batch, script_replace, script_append, script_rename, script_move, script_delete — are MayTriggerReload + RiskLevel:"high" (a written .cs reloads the domain; script_delete is also Delete), so they are NeverInSemi: Approval and Auto return MODE_FORBIDDEN, and only Bypass or an Allowlist hit runs them. Never request a grant for them → operating mode.

Compile and reload

  • Every write returns at once: {success, status: "accepted", path, jobId, waitUrl, serverAvailability}; compilation follows, and the server is briefly unreachable during the domain reload.
  • One call gets the compile result: GET the returned waitUrl (/jobs/<jobId>?wait=90), e.g. curl -s --retry 20 --retry-connrefused --retry-all-errors --retry-delay 2 "http://localhost:<port>/jobs/<jobId>?wait=90". It answers once compilation settles: job status completed, or failed on compile errors, with diagnostics in resultData.compilation (isCompiling, hasErrors, errorCount, errors: [{type, message, file, line}]). During the reload it may refuse or return 503: repeat the same URL; waitTimedOut: true means GET it again.
  • script_get_compile_feedback(scriptPath) returns the same diagnostics on demand. Fix errors first: component_add finds a new MonoBehaviour only after a clean compile.
  • checkCompile: false skips the diagnostics; diagnosticLimit caps them (default 20).

Shared rules

  • scriptName is the file and class name, without .cs or path separators. Paths (folder, scriptPath, newFolder) are project-relative, starting with Assets/ or Packages/; a missing folder is created. An existing file is never overwritten (Script already exists).
  • script_create writes content verbatim when given (then template / namespaceName are ignored, with a warning); otherwise it fills a template — MonoBehaviour (default), ScriptableObject, Editor, EditorWindow (the last two default to Assets/Editor) — wrapped in namespaceName if set. Any other bare name is rejected (validValues lists these four); text containing code stays a literal template with {CLASS}/{NAMESPACE} filled, but use content for custom classes. A MonoBehaviour or ScriptableObject binds to its file only when the class name equals the file name; content declaring no such type gets a warning.
  • 2+ new scripts → script_create_batch: one domain reload instead of N.

Skills Overview

  • Write: script_create, script_create_batch, script_replace (find/replace, plain or regex), script_append (insert lines), script_rename (file only; the class inside is not renamed), script_move (creates the destination folder), script_delete.
  • Read: script_read, script_list, script_find_in_file (plain or regex, per line), script_get_info (class, base class, public members), script_get_compile_feedback.

Per-skill tables and return shapes: reference/<skill_name>.md — rarely needed, the schema notes the parameters.

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)

Elsewhere: API analysis of a compiled script → script_analyze (perception).

Exact Signatures

Names, parameters, defaults and required flags come from GET /skills/schema?category=Script (or ?names=a,b), not this file.

Common Errors

| Error | Trigger → fix | |---|---| | MISSING_PARAM | e.g. scriptName, pattern, find, newName → supply it; the error (or a dryRun) lists all parameters. | | SEMANTIC_INVALID | Path separators in scriptName / newName, a path outside Assets/ / Packages/, or the script already exists → fix the name or path, or rename/move the existing file. | | TARGET_NOT_FOUND | Script, MonoScript or folder missing → find the right scriptPath with script_list / asset_find. | | SKILL_ERROR | A filesystem or AssetDatabase move/rename/delete failed → read the message, resolve it, retry. |

Transport codes (COMPILING, RATE_LIMIT, ...) → error codes.