gh-vivalalova-agent-ide-plugins-skills-agent-ide/references/analyze.md

品質分析 (analyze)

執行方式：以下 agent-ide 指 node ${PLUGIN_ROOT}/bin/agent-ide.js （PLUGIN_ROOT = 此 skill 所在 repo 根目錄，往上三層）

分析程式碼品質，支援多種分析類型。

分析類型

類型	說明
complexity	循環/認知複雜度（預設）
dead-code	未使用的函式/變數
best-practices	ES Module 等實踐檢查
patterns	async/Promise/interface/enum 使用模式
quality	綜合評分（型別安全、錯誤處理、安全性、命名、測試覆蓋率）

用法

# 複雜度分析（預設）
agent-ide analyze --path . --format json

# 指定分析類型
agent-ide analyze dead-code --path . --format json
agent-ide analyze quality --path . --format json

# 顯示所有結果（不只問題項目）
agent-ide analyze --path . --format json --all

參數

參數	說明
[type]	分析類型（可選）
--path	專案路徑
--all	顯示所有結果
--format	輸出格式：json、summary

輸出格式

json（預設）

{
  "command": "analyze",
  "success": true,
  "analyzeType": "complexity",
  "summary": {
    "totalScanned": 25,
    "issuesFound": 3,
    "averageComplexity": 12.5,
    "maxComplexity": 45
  },
  "issues": [
    {
      "type": "complexity",
      "severity": "high",
      "message": "複雜度 45，認知複雜度 32",
      "filePath": "src/services/parser.ts",
      "score": 45
    }
  ]
}

summary

🔍 分析程式碼品質...
分析類型: complexity
成功: 是
發現 16 個問題

🟡 複雜度 11，認知複雜度 9
  src/api/middleware/validator.ts
🟡 複雜度 14，認知複雜度 7
  src/controllers/order-controller.ts
🟠 複雜度 22，認知複雜度 7
  src/models/order-model.ts
🟠 複雜度 32，認知複雜度 24
  src/services/order-service.ts
... 還有 12 個問題

欄位說明

欄位	說明
analyzeType	分析類型
issues	問題列表
issues[].type	問題類型
issues[].severity	嚴重度：critical、high、medium、low
issues[].message	問題描述
issues[].filePath	檔案路徑
issues[].score	分數（複雜度等）
summary.averageComplexity	平均複雜度
summary.maxComplexity	最大複雜度