Kiro Unity Power

讓 Kiro 成為你的 Unity 開發智慧大腦。透過自然語言下達指令，Kiro 經由 MCP（Model Context Protocol）遠端操控 Unity Editor，涵蓋資產管理、場景建置、建置自動化、效能分析、程式碼品質檢查等十大核心功能。

🎬 製作過程影片

👉 觀看完整製作過程

安裝設定

前置需求

Unity Editor 已安裝並開啟專案
Kiro IDE 已安裝
Node.js 18+（僅開發/測試時需要）

兩步安裝

Kiro 端 — 安裝本 Power

Kiro → 左側面板點選 Powers 圖示 → 點擊右上角「+」按鈕 → 選擇「Add Custom Power」→ 選取本專案中的 kiro-unity-power 資料夾
Unity 端 — 安裝 unity-mcp 並啟動 MCP Server

依照以下四個步驟在 Unity Editor 中安裝套件並啟動 MCP Server：

步驟 1：開啟 Unity Editor，點選上方選單 Window → Package Manager

步驟 2：點擊左上角「+」按鈕 → 選擇「Add package from git URL...」→ 貼上以下網址後按 Add：
```
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
```
步驟 3：安裝完成後，點選上方選單 Window → Toggle MCP Window 開啟 MCP 控制面板

步驟 4：確認 MCP Server 狀態顯示為綠燈（已啟動），並在 Terminal 中確認 Server 正常監聽 localhost:8080/mcp

MCP 連線配置

自動配置（推薦）

在上一步的 MCP for Unity 視窗中，選擇「Kiro」選項，然後按下「Configuration」按鈕即可自動完成連線配置，無需手動編輯任何檔案。

手動配置

若自動配置無法使用，可手動編輯 mcp.json。

預設使用 HTTP 模式：

{
  "mcpServers": {
    "unity-mcp": {
      "url": "http://localhost:8080/mcp",
      "transport": "http"
    }
  }
}

若 HTTP 不可用（埠號衝突等），可切換為 stdio 模式：

{
  "mcpServers": {
    "unity-mcp": {
      "command": "uvx",
      "args": ["unity-mcp"],
      "transport": "stdio"
    }
  }
}

驗證連線

在 Kiro 中輸入任意 Unity 相關指令（例如「列出目前場景的物件」），若 Kiro 能正確回應，代表連線成功。

開發與測試

cd kiro-unity-power
npm install

npm test                # 執行所有測試
npm run test:unit       # 僅單元測試
npm run test:property   # 僅屬性測試（fast-check）
npm run test:integration # 僅整合測試
npx tsc --noEmit        # TypeScript 型別檢查

如何使用

在 Kiro 聊天中用自然語言描述你想做的事，Kiro 會自動選擇對應的 MCP 工具執行。

基本指令範例

「把 Characters 資料夾的模型都設定成 Humanoid rig」
「幫我建一個 3D 第一人稱場景」
「建置 Windows 版本」
「檢查專案的程式碼架構」
「檢查 Android 平台的相容性」
「分析 hero.fbx 的依賴關係」

效能分析（FPS 掉幀排查）

當你發現 FPS 掉幀但不確定瓶頸在哪時：

「分析這張 Profiler 截圖的效能瓶頸」
「掃描 Scripts 資料夾的 C# 程式碼，找出效能殺手」
「分析目前場景的效能，產生完整報告」
「Draw Call 太多了，有什麼最佳化方案？」
「GC 分配過高，怎麼修？」

Kiro 會自動執行以下流程：

分析 Profiler 截圖 — 識別 CPU/GPU/記憶體熱點，提取函式耗時排序
掃描 C# 程式碼 — 偵測 Update 中的 GetComponent、Find、字串串接、LINQ、new 分配等反模式
產生最佳化方案 — 針對每個問題給出具體步驟（Object Pool、Batching、Shader 最佳化等）
整合為完整報告 — 依嚴重程度排序，列出前三項優先問題與摘要

程式碼層級使用（進階）

如果你想直接在 TypeScript 中呼叫效能分析模組：

import { analyzeScreenshot } from './src/profiler-screenshot-analyzer';
import { scanScript, scanAllScripts } from './src/code-performance-scanner';
import { generateOptimizations, generateAntipatternFixes } from './src/optimization-advisor';
import { integrateReport } from './src/report-integrator';
import { serializeReport, formatReportAsText } from './src/profiler-serialization';

// 1. 分析截圖
const thresholds = {
  drawCalls: { warning: 200, error: 500 },
  gcAllocation: { warning: 1024, error: 4096 },
  shaderComplexity: { warning: 50, error: 80 },
  frameRate: { warningBelow: 60, errorBelow: 30 },
};

const screenshotResult = analyzeScreenshot({
  description: 'CPU: 85%, GPU: 45%, Memory: 512 MB, Draw Calls: 350, Frame Time: 22 ms, GC: 2048',
  cpuTimeline: [
    { functionName: 'PlayerController.Update', timeMs: 8.5, percentage: 38 },
    { functionName: 'Physics.Simulate', timeMs: 5.2, percentage: 23 },
  ],
}, thresholds);

// 2. 掃描 C# 程式碼
const scanResult = scanAllScripts([
  { filePath: 'Assets/Scripts/Player.cs', content: csharpCode },
]);

// 3. 產生最佳化方案
const plans = generateOptimizations(screenshotResult.hotspots);
const fixes = generateAntipatternFixes(scanResult.antipatterns);

// 4. 整合報告
const report = integrateReport(screenshotResult, scanResult, [...plans, ...fixes]);

// 5. 輸出
console.log(formatReportAsText(report));       // 人類可讀文字
const json = serializeReport(report);          // JSON（可儲存追蹤趨勢）

功能列表

十大核心功能

功能	說明	對應 Steering
資產設定自動化	批次套用 Asset Preset、自動偵測資產類型、變更摘要	`asset-automation.md`
場景建置加速	從 Scene Scaffold 一鍵生成場景結構	`scene-scaffolding.md`
建置自動化	一鍵本地建置，可選 Cloud Assist 雲端加速	`build-automation.md`
跨平台測試	本地模擬測試 + 可選雲端真實裝置測試	`cross-platform-testing.md`
工作流自動化	定義多步驟工作流，自動依序執行	`workflow-automation.md`
效能分析	Profiler 截圖分析、程式碼反模式掃描、最佳化建議	`performance-analysis.md`
程式碼品質	MVC/ECS/ScriptableObject 架構檢查、循環依賴偵測	`code-quality.md`
知識管理	團隊文件集中管理、API 變更追蹤、過期偵測	`knowledge-management.md`
平台相容性	Shader 相容性、記憶體預算、三級嚴重度分類	`platform-compatibility.md`
資產依賴管理	依賴樹、孤立資產偵測、AssetBundle 重複檢查	`asset-dependencies.md`
關卡設計工具鏈	Editor 擴展腳本生成、ScriptableObject 模板建立、場景物件批次設定	`level-design-tooling.md`

效能分析器模組

模組	功能
`ProfilerScreenshotAnalyzer`	解析 Profiler 截圖，提取 CPU/GPU/記憶體指標，識別熱點
`CodePerformanceScanner`	掃描 C# 程式碼中的效能反模式（11 種已知模式）
`OptimizationAdvisor`	針對熱點與反模式產生結構化最佳化方案
`ReportIntegrator`	整合所有分析結果為完整報告，依嚴重程度排序
`ProfilerSerialization`	報告的 JSON 序列化/反序列化與人類可讀文字格式化

偵測的效能反模式：

類別	反模式	嚴重程度
Update 方法	`GetComponent` 呼叫	Error
Update 方法	`Find`/`FindObjectOfType` 呼叫	Error
Update 方法	字串串接	Warning
Update 方法	LINQ 查詢	Warning
Update 方法	`new` 物件分配	Warning
GC 分配	頻繁建立暫時陣列/集合	Warning
GC 分配	`foreach` 非泛型集合	Suggestion
GC 分配	閉包捕獲	Suggestion
Draw Call	未使用 Static Batching	Suggestion
Draw Call	GPU Instancing 停用	Warning
Draw Call	過多獨立材質	Warning

最佳化建議對照：

問題類別	建議方案
Draw Call 過多	Static/Dynamic Batching、GPU Instancing、LOD Group、Occlusion Culling
GC 分配過高	Object Pool、快取 GetComponent、StringBuilder、避免每幀分配
Shader 複雜度高	簡化運算、減少取樣、Shader LOD、URP/Mobile Shader
CPU 耗時過高	Coroutine/Job System、簡化碰撞體、降低 FixedUpdate 頻率

UI 依賴分析模組

分析 UI 元件與遊戲邏輯之間的跨文件依賴關係，追蹤事件調用鏈，評估耦合度並提供重構建議。

模組	功能
`UIReferenceTracker`	掃描 C# 腳本，追蹤所有引用特定 UI 元件的腳本，建構依賴圖
`EventChainAnalyzer`	從 UI 事件起點追蹤完整調用鏈，偵測循環與過深調用
`CouplingAdvisor`	計算 UI 與遊戲邏輯之間的耦合分數，產生重構建議
`UIDependencyReport`	整合所有分析結果為結構化報告，依耦合分數排序
`UIDependencySerialization`	報告的 JSON 序列化/反序列化與人類可讀文字格式化

自然語言指令範例：

「追蹤所有引用 Button 的腳本」
「分析 StartButton 的 onClick 事件調用鏈」
「評估 UI 與遊戲邏輯的耦合度，給我重構建議」
「產生完整的 UI 依賴分析報告」

API 文件

trackUIReferences(scripts, targetComponent) — UI 元件引用追蹤

import { trackUIReferences } from './src/ui-reference-tracker';

const scripts = [
  { filePath: 'Assets/Scripts/UIManager.cs', content: csharpCode },
];

// 依類型查詢
const result = trackUIReferences(scripts, { typeName: 'Button' });

// 依名稱查詢
const result2 = trackUIReferences(scripts, { name: 'startButton' });

scripts: { filePath: string; content: string }[] — C# 腳本清單
targetComponent: { name?: string; typeName?: string } — 查詢條件（名稱或類型）
回傳 UIReferenceResult：
- references — 引用清單，每筆包含 filePath、lineNumber、referenceMethod、componentType、fieldName
- highFanInComponents — 被 3 個以上腳本引用的元件（高扇入警告）
- failedFiles — 掃描失敗的檔案清單

偵測的引用模式：

引用方式	範例
`SerializeField`	`[SerializeField] private Button startBtn;`
`PublicField`	`public Button startBtn;`
`GetComponent`	`GetComponent<Button>()`
`GetComponentInChildren`	`GetComponentInChildren<Slider>()`
`GameObjectFind`	`GameObject.Find("StartButton")`
`TransformFind`	`transform.Find("Panel/Button")`
`AddComponent`	`AddComponent<Toggle>()`

buildUIDependencyGraph(scripts) — 建構 UI 依賴圖

import { buildUIDependencyGraph } from './src/ui-reference-tracker';

const graph = buildUIDependencyGraph(scripts);
// graph.nodes — 腳本節點與 UI 元件節點
// graph.edges — 每條邊對應一筆引用關係

analyzeEventChain(scripts, entryPoint, options?) — 事件調用鏈分析

import { analyzeEventChain } from './src/event-chain-analyzer';

const result = analyzeEventChain(scripts, {
  scriptPath: 'Assets/Scripts/UIManager.cs',
  componentType: 'Button',
  eventName: 'onClick',
}, { maxDepth: 10 });

// result.chains — 所有調用鏈
// result.deepChainCount — 深度 > 5 的調用鏈數量
// result.cycleCount — 偵測到的循環數量

entryPoint: { scriptPath, componentType, eventName } — 事件起點
options.maxDepth — 最大追蹤深度（預設 10）
偵測的事件訂閱模式：AddListener、+= 訂閱、SerializedUnityEvent、SendMessage、BroadcastMessage
偵測的狀態變更：靜態欄位寫入、ScriptableObject 修改、PlayerPrefs 寫入、Singleton 狀態修改
深度 > 5 標記為過深調用鏈
使用 cycle-detection.ts 偵測循環並中止遞迴

calculateCouplingScores(referenceResult, chainResult) — 耦合分數計算

import { calculateCouplingScores, generateRefactoringSuggestions } from './src/coupling-advisor';

const pairs = calculateCouplingScores(referenceResult, chainResult);
const suggestions = generateRefactoringSuggestions(pairs, 5.0); // 閾值預設 5.0

耦合分數計算公式：

因素	權重
直接引用數量	× 1.0
事件調用鏈深度	× 0.5 × 深度
共享狀態變更數量	× 2.0
雙向依賴	+ 10.0

generateRefactoringSuggestions(pairs, threshold?) — 重構建議

分數超過閾值時產生建議，四種類型：

類型	觸發條件	影響程度
`EventBus`	雙向依賴或直接引用 > 1	high / medium
`ScriptableObjectChannel`	共享狀態變更 > 0	medium
`LayerSeparation`	調用鏈深度 > 5	medium
`InterfaceDecoupling`	雙向依賴或其他條件未觸發	high / low

integrateUIDependencyReport(...) — 報告整合

import { integrateUIDependencyReport } from './src/ui-dependency-report';

const report = integrateUIDependencyReport(
  referenceResult,  // trackUIReferences 的結果
  chainResult,      // analyzeEventChain 的結果
  couplingPairs,    // calculateCouplingScores 的結果
  suggestions,      // generateRefactoringSuggestions 的結果
);

// report.summary — 摘要（UI 元件總數、引用總數、事件調用鏈總數等）
// report.couplingPairs — 依 couplingScore 由高到低排序

serializeUIDependencyReport / deserializeUIDependencyReport / formatUIDependencyReportAsText — 序列化三件組

import {
  serializeUIDependencyReport,
  deserializeUIDependencyReport,
  formatUIDependencyReportAsText,
} from './src/ui-dependency-serialization';

const json = serializeUIDependencyReport(report);     // JSON 字串
const restored = deserializeUIDependencyReport(json);  // 還原物件（無效 JSON 拋出錯誤）
const text = formatUIDependencyReportAsText(report);   // 人類可讀文字

端對端使用情境

情境 1：追蹤單一 UI 元件的跨文件引用

import { trackUIReferences } from './src/ui-reference-tracker';

const scripts = loadAllCSharpScripts(); // 你的腳本載入邏輯
const result = trackUIReferences(scripts, { typeName: 'Button' });

console.log(`找到 ${result.references.length} 筆 Button 引用`);
for (const ref of result.references) {
  console.log(`  ${ref.filePath}:${ref.lineNumber} [${ref.referenceMethod}] ${ref.fieldName}`);
}
if (result.highFanInComponents.length > 0) {
  console.log('⚠️ 高扇入元件（被 3+ 腳本引用）：');
  for (const c of result.highFanInComponents) {
    console.log(`  ${c.componentType} ${c.fieldName} — ${c.referenceCount} 個引用`);
  }
}

情境 2：解析完整事件調用鏈

import { analyzeEventChain } from './src/event-chain-analyzer';

const result = analyzeEventChain(scripts, {
  scriptPath: 'Assets/Scripts/MainMenu.cs',
  componentType: 'Button',
  eventName: 'onClick',
});

for (const chain of result.chains) {
  console.log(`調用鏈（深度 ${chain.depth}）${chain.isDeepChain ? ' ⚠️ 過深' : ''}`);
  for (const node of chain.nodes) {
    console.log(`  → ${node.scriptPath}:${node.lineNumber} ${node.functionName} [${node.nodeType}]`);
  }
  if (chain.cyclePath) {
    console.log(`  🔄 循環：${chain.cyclePath.join(' → ')}`);
  }
}

情境 3：取得耦合分數與重構建議

import { calculateCouplingScores, generateRefactoringSuggestions } from './src/coupling-advisor';
import { integrateUIDependencyReport } from './src/ui-dependency-report';
import { formatUIDependencyReportAsText } from './src/ui-dependency-serialization';

const pairs = calculateCouplingScores(referenceResult, chainResult);
const suggestions = generateRefactoringSuggestions(pairs);
const report = integrateUIDependencyReport(referenceResult, chainResult, pairs, suggestions);

console.log(formatUIDependencyReportAsText(report));

與現有模組的整合

現有模組	整合方式
`dependency-analysis.ts`	UI 依賴分析擴展資產依賴分析，專注於 UI 元件與腳本之間的引用關係
`cycle-detection.ts`	`EventChainAnalyzer` 直接複用 `detectCycles` 偵測事件調用鏈中的循環
`architecture-check.ts`	共享 `ScriptFile` 介面（`{ filePath, content }`），使用相同的靜態分析方法（正則表達式匹配）

詞彙表

術語	說明
UI_Component	Unity UI 元件（Button、Toggle、Slider、InputField、Dropdown、ScrollRect、Text、Image）
Script_Reference	C# 腳本對 UI 元件的引用，包含引用方式與位置
Event_Chain	從 UI 事件觸發到遊戲狀態變更的完整調用路徑
Event_Node	調用鏈中的單一節點（事件觸發、事件處理、狀態變更）
Coupling_Score	兩個模組之間的耦合程度數值，越高越耦合
Refactoring_Suggestion	針對耦合過深的程式碼提出的重構方案
High_Fan_In	被 3 個以上腳本引用的 UI 元件，潛在的維護風險
State_Mutation	遊戲狀態變更（靜態欄位寫入、ScriptableObject 修改、PlayerPrefs 寫入、Singleton 修改）

關卡設計工具鏈模組

協助企劃與開發者快速生成 Unity Editor 擴展腳本、建立 ScriptableObject 關卡配置模板，以及自動化場景物件的批次設定。

模組	功能
`EditorExtensionGenerator`	根據目標類別生成 Custom Inspector 與 EditorWindow 批次工具的 C# 腳本
`ScriptableObjectTemplate`	根據欄位定義生成 ScriptableObject C# 腳本與配套 Inspector
`SceneBatchConfigurator`	解析批次設定規則、篩選場景物件、產生並執行 MCP 呼叫序列
`TemplateRegistry`	管理 SO 模板與批次規則的 CRUD，支援 JSON 持久化

自然語言指令範例：

「幫我為 EnemyConfig 生成一個自定義 Inspector」
「建立一個關卡配置 ScriptableObject，包含名稱、難度（1-10）、敵人波次列表、獎勵物品」
「把所有名稱包含 Enemy 的物件 Layer 設為 Enemy」
「所有 BoxCollider 的 isTrigger 設為 true」
「列出所有關卡配置模板」
「載入 LevelConfig 模板並生成腳本」

三大功能

1. Editor 擴展腳本生成

根據目標 MonoBehaviour 或 ScriptableObject 類別，自動生成 Custom Inspector 或批次處理工具的 C# 腳本。

自動查詢目標類別的序列化欄位，為每個欄位生成對應的 GUI 控制項
Inspector 腳本包含 Undo.RecordObject 支援，所有修改可復原
批次工具腳本包含進度條顯示（EditorUtility.DisplayProgressBar）
腳本自動放置於 Assets/Editor/，命名遵循 {ClassName}Inspector.cs 或 {ToolName}Window.cs

2. ScriptableObject 關卡配置模板

根據自然語言描述生成結構化的 ScriptableObject 腳本，含驗證規則與自定義 Inspector。

自動加上 [CreateAssetMenu]，可在 Unity 右鍵選單建立資產
每個欄位生成 [Tooltip] 中文說明
支援驗證規則：[Range]、[Min] 等屬性，以及 OnValidate 自動檢查
支援列表型別（List<T> + [SerializeField]）與巢狀結構（[System.Serializable]）
同時生成配套的自定義 Inspector 腳本

3. 場景物件批次設定

自動化設定場景中大量物件的 Layer、Tag 及組件參數。

支援篩選條件組合：物件名稱（萬用字元）、Tag、Layer、組件類型、父物件路徑
執行前顯示預覽清單，確認後才套用
多規則依序執行，互不影響
完成後產生變更摘要報告（成功數量、跳過數量與原因）

程式碼層級使用（進階）

生成 Custom Inspector

import { generateInspectorScript } from './src/editor-extension-gen';

const result = generateInspectorScript({
  targetClassName: 'EnemyConfig',
  fields: [
    { name: 'health', typeName: 'int', isEnum: false, isList: false },
    { name: 'speed', typeName: 'float', isEnum: false, isList: false },
    { name: 'enemyType', typeName: 'EnemyType', isEnum: true, isList: false },
  ],
});

console.log(result.fileName);  // "EnemyConfigInspector.cs"
console.log(result.filePath);  // "Assets/Editor/EnemyConfigInspector.cs"
console.log(result.content);   // 完整的 C# Inspector 腳本

生成 ScriptableObject 模板

import { generateSOScript } from './src/scriptableobject-template';

const result = generateSOScript({
  className: 'LevelConfig',
  menuPath: 'LevelDesign/Level Config',
  fileName: 'NewLevelConfig',
  description: '關卡配置資料',
  fields: [
    { name: 'levelName', typeName: 'string', tooltip: '關卡名稱', isNested: false },
    {
      name: 'difficulty', typeName: 'int', tooltip: '難度等級',
      validation: { type: 'range', params: { min: 1, max: 10 } },
      isNested: false,
    },
    {
      name: 'enemyWaves', typeName: 'EnemyWave', tooltip: '敵人波次列表',
      isList: true, isNested: true,
      nestedFields: [
        { name: 'enemyType', typeName: 'string', tooltip: '敵人類型', isNested: false },
        { name: 'count', typeName: 'int', tooltip: '數量', isNested: false },
      ],
    },
  ],
  createdAt: new Date().toISOString(),
  updatedAt: new Date().toISOString(),
  version: 1,
});

// result.soScript      — ScriptableObject C# 腳本
// result.inspectorScript — 配套 Inspector C# 腳本

批次設定場景物件

import { parseBatchRules, matchGameObjects, generatePreview, translateToMcpCalls } from './src/scene-batch-config';

// 解析規則
const rules = parseBatchRules('所有名稱包含 Enemy 的物件設定 Layer 為 Enemy');

// 產生篩選 MCP 呼叫
const findCall = matchGameObjects(rules[0].filters);

// 假設篩選結果為以下物件
const matchedObjects = ['Enemy_01', 'Enemy_02', 'Enemy_03'];

// 產生預覽
const preview = generatePreview(matchedObjects, rules[0].actions);

// 轉譯為 MCP 呼叫序列
const mcpCalls = translateToMcpCalls(matchedObjects, rules[0].actions);

模板管理

import { saveTemplate, loadTemplate, listTemplates, deleteTemplate } from './src/template-registry';
import { saveBatchRule, loadBatchRule, listBatchRules } from './src/template-registry';

// 儲存模板
saveTemplate(soTemplateDefinition);

// 列出所有模板
const templates = listTemplates();
// [{ name, description, fieldSummary, createdAt, updatedAt, version }]

// 載入模板
const template = loadTemplate('LevelConfig');

// 儲存批次規則
saveBatchRule(batchRule);

// 列出所有批次規則
const rules = listBatchRules();

持久化路徑

資料類型	儲存路徑
SO 模板定義	`Assets/KiroUnityPower/Config/LevelDesign/Templates/{className}.json`
批次設定規則	`Assets/KiroUnityPower/Config/LevelDesign/BatchRules/{name}.json`

自訂模板與規則放在 Unity 專案目錄下，優先於內建範本載入。

內建範本

類型	數量	路徑	範例
Asset Preset	5	`templates/presets/`	`3d-character.json`、`2d-sprite.json`、`ui-texture.json`
Scene Scaffold	5	`templates/scaffolds/`	`3d-first-person.json`、`2d-platformer.json`、`ui-menu.json`
建置配置	4	`templates/build-configs/`	`windows-dev.json`、`android-release.json`
平台設定檔	4	`templates/platform-profiles/`	`ios.json`、`android.json`、`webgl.json`
架構規則	3	`templates/architecture-rules/`	`mvc-pattern.json`、`ecs-pattern.json`
工作流範本	3	`templates/workflows/`	`asset-import-setup.json`、`build-and-deploy.json`

自訂範本放在 Unity 專案的 Assets/KiroUnityPower/Config/ 對應子目錄下，優先於內建範本載入。

Kiro Power 原理說明

架構

開發者（自然語言）→ Kiro（AI 大腦）→ MCP 協議 → Unity Editor（執行層）
                        ↑
                  Kiro Unity Power（智慧層）
                  ├── POWER.md        → Kiro 讀取的主文件，定義工具與工作流
                  ├── steering/       → 11 個領域知識文件，按情境自動載入
                  ├── templates/      → 預設範本（Preset、Scaffold、Build Config 等）
                  └── src/            → TypeScript 工具模組（效能分析、報告產生等）

三層分工

層級	角色	說明
Kiro（AI 大腦）	理解意圖、規劃策略	解析開發者的自然語言指令，決定要呼叫哪些 MCP 工具、以什麼順序執行
Kiro Unity Power（智慧層）	領域知識、範本、分析邏輯	提供 Unity 開發的專業知識（steering files）、預設範本（templates）、效能分析模組（src）
unity-mcp（執行層）	操控 Unity Editor	開源 MCP Server，接收 Kiro 的工具呼叫並在 Unity Editor 中執行實際操作

POWER.md

POWER.md 是 Kiro 讀取的主文件，定義了：

所有可用的 MCP 工具與參數
十大工作流的完整步驟（資產設定、場景建置、建置、測試、效能分析等）
錯誤處理策略與降級機制
範本載入優先順序

Steering Files

steering/ 目錄下的 12 個 Markdown 文件，根據開發者的請求情境自動載入對應的領域知識：

文件	載入時機
`unity-general.md`	所有請求（基礎知識）
`asset-automation.md`	資產相關操作
`scene-scaffolding.md`	場景建置
`build-automation.md`	建置相關
`performance-analysis.md`	效能分析
`code-quality.md`	程式碼品質檢查
`platform-compatibility.md`	平台相容性
`asset-dependencies.md`	資產依賴分析
`cross-platform-testing.md`	跨平台測試
`workflow-automation.md`	工作流自動化
`knowledge-management.md`	知識管理

| level-design-tooling.md | 關卡設計相關操作 |

專案結構

kiro-unity-power/
├── POWER.md                    # Kiro 讀取的主文件
├── mcp.json                    # MCP Server 連線配置
├── steering/                   # 領域知識 Steering Files（12 個）
├── templates/
│   ├── presets/                # Asset Preset（5 種）
│   ├── scaffolds/              # Scene Scaffold（5 種）
│   ├── build-configs/          # 建置配置（4 種）
│   ├── platform-profiles/      # 平台設定檔（4 種）
│   ├── architecture-rules/     # 架構規則（3 種）
│   └── workflows/              # 工作流範本（3 種）
├── src/                        # TypeScript 工具模組
│   ├── types.ts                # 所有型別定義
│   ├── profiler-screenshot-analyzer.ts  # Profiler 截圖分析
│   ├── code-performance-scanner.ts      # C# 程式碼反模式掃描
│   ├── optimization-advisor.ts          # 最佳化建議產生
│   ├── report-integrator.ts             # 報告整合
│   ├── profiler-serialization.ts        # 報告序列化/格式化
│   ├── performance-report.ts            # 效能報告基礎模組
│   ├── memory-budget.ts                 # 記憶體預算檢查
│   ├── ui-reference-tracker.ts          # UI 元件跨文件引用追蹤
│   ├── event-chain-analyzer.ts          # 事件調用鏈分析
│   ├── coupling-advisor.ts              # 耦合度評估與重構建議
│   ├── ui-dependency-report.ts          # UI 依賴分析報告整合
│   ├── ui-dependency-serialization.ts   # UI 依賴報告序列化/格式化
│   ├── editor-extension-gen.ts          # Editor 擴展腳本生成
│   ├── scriptableobject-template.ts     # ScriptableObject 模板建立
│   ├── scene-batch-config.ts            # 場景物件批次設定
│   ├── template-registry.ts             # 模板與規則 CRUD 管理
│   ├── mcp-integration.ts              # MCP 整合與工作流串接
│   └── ...                              # 其他工具模組
├── tests/
│   ├── unit/                   # 單元測試
│   └── property/               # 屬性測試（fast-check）
├── package.json
├── tsconfig.json
└── jest.config.ts

疑難排解

問題	解法
Kiro 無法連線 Unity	確認 Unity Editor 已開啟 → Window → MCP for Unity → Start Server
埠號 8080 被佔用	關閉佔用程式，或在 `mcp.json` 改用 stdio 模式
資產操作無回應	Unity 可能正在編譯，等待編譯完成後重試
Cloud Assist 失敗	自動降級為本地模式，核心功能不受影響
測試失敗	執行 `cd kiro-unity-power && npm test` 查看詳細錯誤訊息
TypeScript 型別錯誤	執行 `npx tsc --noEmit` 檢查，確認 `npm install` 已安裝依賴

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
.kiro/specs		.kiro/specs
image		image
kiro-unity-power		kiro-unity-power
.gitignore		.gitignore
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

Kiro Unity Power

🎬 製作過程影片

安裝設定

前置需求

兩步安裝

MCP 連線配置

自動配置（推薦）

手動配置

驗證連線

開發與測試

如何使用

基本指令範例

效能分析（FPS 掉幀排查）

程式碼層級使用（進階）

功能列表

十大核心功能

效能分析器模組

UI 依賴分析模組

API 文件

端對端使用情境

與現有模組的整合

詞彙表

關卡設計工具鏈模組

三大功能

程式碼層級使用（進階）

持久化路徑

內建範本

Kiro Power 原理說明

架構

三層分工

POWER.md

Steering Files

專案結構

疑難排解

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages