| name | code-reviewer |
| description | Analyze project source code and generate optimization suggestions. Use when user wants code review, performance optimization advice, security hardening recommendations, or architecture improvement suggestions. |
Code Reviewer
AST 驅動的專案原始碼分析，產生優化建議報告（Go / Python / JavaScript / TypeScript）。
Command Syntax
/code-reviewer [PROJECT_PATH] [OUTPUT_FILE]
Parameters (All Optional)
| Parameter | Default | Description |
|---|
PROJECT_PATH | Current directory | 專案根目錄路徑 |
OUTPUT_FILE | .doc/code-reviewer/{yyyy-MM-dd_HH-mm}.md | 輸出檔案路徑（相對於 PROJECT_PATH） |
Output Path Rules
- 預設路徑：
{PROJECT_PATH}/.doc/code-reviewer/{yyyy-MM-dd_HH-mm}.md
- 時間戳使用 24 小時制本地時間（例：
2026-04-25_14-30.md）
- 不存在時自動建立
.doc/code-reviewer/ 目錄
- 顯式覆寫：傳入
OUTPUT_FILE 時直接使用該路徑；路徑若含目錄請先自行建立
- 永遠不在專案根目錄落檔 — 所有產出集中於
.doc/code-reviewer/
- 零問題 + 零有效建議時不落檔 — 見下節「No-Op 條件」
Examples
/code-reviewer
/code-reviewer ./my-project
/code-reviewer . custom.md
Supported Languages
| Language | Analyzer | Dependencies |
|---|
| Go | go/ast（via go run helper）+ 字串掃描 | go ≥ 1.21 |
| Python | 內建 ast 模組 | Python ≥ 3.10 |
| JavaScript / TypeScript | 內建輕量結構掃描（brace-based 函式邊界／巢狀深度）+ 專案本地 eslint（可選）+ 字串掃描 | node_modules/.bin/eslint（可選） |
對應工具鏈不可用時，自動降級為字串掃描並在報告中標示。
Workflow
1. Detect → 偵測專案主要語言（依 go.mod / tsconfig.json / package.json / pyproject.toml）
2. Analyze → 呼叫對應分析器（AST + 字串掃描）
3. Evaluate → 計算指標並依嚴重度排序問題
4. Gate → 檢查 No-Op 條件；若命中則跳過 Generate / Save，僅輸出無需處理訊息
5. Generate → 產生優化建議報告（繁體中文），套用 Recommendation Principles 過濾
6. Save → `mkdir -p {PROJECT_PATH}/.doc/code-reviewer/` 後寫入 `{yyyy-MM-dd_HH-mm}.md`
No-Op 條件（同時滿足時不產檔）
issue_counts 的 critical / high / medium / low 皆為 0- 套用 Recommendation Principles 後，架構 / 效能 / 安全三段皆無有效建議（即都會寫「未觀察到需處理事項」）
- 未觀察到超標 metric（見
scripts/recommendation_principles.md 例外欄位定義）
命中時的行為：
- 不建立
.doc/code-reviewer/ 目錄
- 不寫入報告檔
- 對使用者輸出一行訊息：
無需處理：{language} 專案 {name}（{file_count} 檔 / {function_count} 函式）未觀察到可執行建議
- 若使用者顯式指定
OUTPUT_FILE，視為強制產檔請求，仍寫入（內容可為「未觀察到需處理事項」的最小報告）
Go-Specific Preprocessing
對每個非測試 .go 檔案自動執行 gofmt -s -w（失敗時靜默略過）。
Step 1: Analyze Project
python3 ~/.claude/skills/code-reviewer/scripts/analyze_code.py /path/to/project
Output: JSON 包含：
language: 主要語言files: 檔案列表functions: 函式資訊（名稱、簽章、行數、文件註解狀態）issues: 偵測到的問題issue_counts: 各嚴重度計數metrics: 程式碼指標（總行數、平均函式長度、最大巢狀深度）dependencies: 依賴套件
Reference Documents
執行各階段時讀取對應參考檔：
Validation Checklist
