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

Running EditMode/PlayMode tests
Discovering or listing tests
Polling async test results
Scaffolding test files
运行 EditMode/PlayMode 测试、发现或列出测试、轮询异步测试结果、生成测试文件

Test Skills

Run and manage Unity tests.

Operating Mode

Approval: 只读 skill（

test_get_result

test_list

test_discover_get_result

test_get_last_result

test_list_categories

test_smoke_skills

test_get_summary

，标

SkillMode.SemiAuto

）直接执行；执行/发现/创建型 skill（

test_run

test_run_by_name

test_discover_start

test_cancel

test_create_editmode

test_create_playmode

，默认

SkillMode.FullAuto

）需用户 grant，grant 后服务端一步执行返结果（job 立即排进队列）。

Auto / Bypass: 直接执行。
本模块有 4 个 NeverInSemi skill（按
```
IsForbiddenInSemi
```
自动判定）：
- ```
MayEnterPlayMode = true
```
  :
```
test_run
```
  、
```
test_run_by_name
```
- ```
MayTriggerReload = true
```
  :
```
test_create_editmode
```
  、
```
test_create_playmode
```
  （同时标
```
MutatesAssets = true
```
  ）
Approval 模式下这 4 个返
```
MODE_FORBIDDEN
```
，仅 Bypass 或 Allowlist 命中可绕过。注意：
```
test_run(testMode="PlayMode")
```
/
```
test_run_by_name
```
会让 Unity TestRunner 切入 PlayMode；
```
test_create_editmode
```
/
```
test_create_playmode
```
落盘新的 .cs 文件后会触发 Domain Reload。

异步约定：

test_run

test_run_by_name

test_discover_start

test_create_*

立即返回

jobId

；用

test_get_result(jobId)

test_discover_get_result(jobId)

轮询；Unity TestRunner 串行化，正在跑测试时不要再起第二个
test_run
。

DO NOT (common hallucinations):

```
test_run_all
```
does not exist → use
```
test_run
```
or
```
test_run_by_name
```

test_create_template

does not exist → use

test_create_editmode

test_create_playmode

```
test_get_status
```
does not exist → use
```
test_get_result
```
with
```
jobId
```
from test run
Test skills are async — they return a
```
jobId
```
, poll with
```
test_get_result(jobId)
```
Unity Test Runner is serialized here: do not start a second
```
test_run
```
while another test job is still active
Prefer
```
unity_skills.get_skills(category="Test")
```
or
```
GET /skills/schema
```
for exact signatures instead of guessing from memory

Routing:

For compile error checking → use
```
debug
```
module's
```
debug_check_compilation
```
For test script creation →
```
test_create_editmode
```
/
```
test_create_playmode
```
, then modify via
```
script
```
module
For broad regression probes across many skills →
```
test_smoke_skills
```
, which uses transient probes to avoid polluting workflow/batch persistence

Skills

test_list

List available tests via Unity Test Runner async discovery. Returns
pendingDiscovery=true
+
discoveryJobId
on first call (cache miss) — poll

test_discover_get_result(jobId)

then retry

test_list

. Parameters:

```
testMode
```
(string, optional): EditMode or PlayMode. Default: EditMode.
```
limit
```
(int, optional): Max tests to list. Default: 100.

Returns:

{ success, testMode, count, total, truncated, tests, pendingDiscovery, discoveryJobId, discoveryStatus }

— here

count

is how many came back and

total

is how many were discovered,

truncated: true

means raise

limit

. (

test_discover_get_result

uses

count

for the total instead — see the warning there.)

test_run

Run Unity tests asynchronously. Returns a

jobId

immediately; poll with

test_get_result(jobId)

. Parameters:

```
testMode
```
(string, optional): EditMode or PlayMode. Default: EditMode. Returns:
```
{ success, status, jobId, kind, testMode, filter, message }
```

test_get_result

Get the result of a test run. Parameters:

```
jobId
```
(string, required): Job ID from
```
test_run
```
/
```
test_run_by_name
```
.

Returns:

{ success, jobId, status, totalTests, passedTests, failedTests, skippedTests, inconclusiveTests, otherTests, failedTestNames, failedTestDetails, elapsedSeconds, resultSummary, error }

— each failure detail includes

name

resultState

message

stackTrace

durationSeconds

, and

output

test_cancel

Cancel a running test job if supported (Unity TestRunner has no hard cancel — best-effort). Parameters:

```
jobId
```
(string, required): Job ID to cancel.

Returns:

{ success, jobId, status, cancelled, note, warnings }

test_discover_start

Start asynchronous Unity Test Runner discovery and return a discovery

jobId

. Use this directly when you want explicit control over discovery; otherwise

test_list

test_list_categories

will trigger it on cache miss.

Parameter	Type	Required	Default	Description
testMode	string	No	EditMode	EditMode or PlayMode

Returns:

{ success, status, jobId, kind, testMode, message }

test_discover_get_result

Get the result of an asynchronous Unity Test Runner discovery job.

Parameter	Type	Required	Default	Description
jobId	string	Yes	-	Discovery job ID
limit	int	No	100	Max tests in the response; the default silently caps a larger suite

Returns:

{ success, jobId, status, testMode, discoveryMode, count, returned, truncated, tests, error }

Here
count
is the total and
returned
is what you got.
count
is how many tests the discovery found,
returned
is how many are in
tests
after
limit
was applied,
truncated: true
says the two differ — raise
limit
to see the rest. A project with 300 tests answers
count: 300, returned: 100, truncated: true
under the default. Never derive the suite size from
len(tests)
.
⚠️ count
means the opposite thing in
test_list
. There
count
is the returned length and
total
is the discovered size; here
count
is the discovered size and
returned
is the returned length. The two skills were shipped that way and each one's
count
is frozen for wire compatibility, so do not assume symmetry — read
truncated
(present on both) to know whether you are looking at a partial list, and take the total from
total
in
test_list
but from
count
here.

test_run_by_name

Run specific tests by class or method name.

Parameter	Type	Required	Default	Description
testName	string	Yes	-	Test class or method name to run
testMode	string	No	EditMode	EditMode or PlayMode

Returns:

{ success, jobId, testName, testMode }

test_get_last_result

Get the most recent test run result.

No parameters.

Returns:

{ jobId, status, total, passed, failed, skipped, inconclusive, other, failedNames }

test_list_categories

List test categories via Unity Test Runner async discovery. Same cache-miss / poll pattern as

test_list

Parameter	Type	Required	Default	Description
testMode	string	No	EditMode	EditMode or PlayMode

Returns:

{ success, count, categories, pendingDiscovery, discoveryJobId, discoveryStatus }

test_smoke_skills

Run a reusable smoke test across registered skills.

Parameter	Type	Required	Default	Description
category	string	No	-	Only test one skill category
nameContains	string	No	-	Filter skills by partial name
excludeNamesCsv	string	No	-	Comma-separated skill names to exclude
executeReadOnly	bool	No	true	Execute safe read-only skills directly
includeMutating	bool	No	true	Include mutating skills via dryRun smoke testing
limit	int	No	0	Max skills to inspect; 0 means all

Returns:

{ success, totalSkills, executedCount, dryRunCount, failureCount, results }

test_create_editmode

Create an EditMode test script template. Writes the .cs file synchronously and returns a compile-monitor

jobId

; the script create will trigger a Domain Reload, so the server may be temporarily unavailable —

serverAvailability

carries the transient-unavailable hint.

Parameter	Type	Required	Default	Description
testName	string	Yes	-	Name of the test class to create
folder	string	No	Assets/Tests/Editor	Folder path for the test script

Returns:

{ success, status, path, testName, jobId, serverAvailability }

test_create_playmode

Create a PlayMode test script template. Writes the .cs file synchronously and returns a compile-monitor

jobId

; same Domain Reload + transient-unavailable note as

test_create_editmode

Parameter	Type	Required	Default	Description
testName	string	Yes	-	Name of the test class to create
folder	string	No	Assets/Tests/Runtime	Folder path for the test script

Returns:

{ success, status, path, testName, jobId, serverAvailability }

test_get_summary

Get aggregated test summary across all runs.

No parameters.

Returns:

{ success, totalRuns, completedRuns, totalPassed, totalFailed, totalSkipped, totalInconclusive, totalOther, allFailedTests }

Minimal Example

python

import unity_skills, time

# Run tests and poll for result (async pattern required)
result = unity_skills.call_skill("test_run", testMode="EditMode")
job_id = result["jobId"]

# Poll until done (test_* skills are async)
for _ in range(30):
    status = unity_skills.call_skill("test_get_result", jobId=job_id)
    if status.get("status") == "Completed":
        print(f"Passed: {status['totalPassed']}, Failed: {status['totalFailed']}")
        break
    time.sleep(2)

Exact Signatures

Exact names, parameters, defaults, and returns are defined by

GET /skills/schema

unity_skills.get_skill_schema()

, not by this file.

unity-test

NPX Install

Tags

SKILL.md Content

Triggers

Test Skills

Operating Mode

Skills

`test_list`

`test_run`

`test_get_result`

`test_cancel`

`test_discover_start`

`test_discover_get_result`

`test_run_by_name`

`test_get_last_result`

`test_list_categories`

`test_smoke_skills`

`test_create_editmode`

`test_create_playmode`

`test_get_summary`

Minimal Example

Exact Signatures