Initial commit

references/analyze.md

@@ -0,0 +1,99 @@
+# 品質分析 (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` | 綜合評分（型別安全、錯誤處理、安全性、命名、測試覆蓋率） |
+
+## 用法
+
+```bash
+# 複雜度分析（預設）
+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（預設）
+
+```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` | 最大複雜度 |