code-reviewer

name	code-reviewer
version	1.0.0
description	程式碼審查，包裝 PAL MCP 的 codereview 功能
author	miles990
tags	["code-review","quality","security","performance"]
dependencies	{"mcp":[{"package":"pal-mcp-server","required":true,"note":"使用 pal.codereview 進行審查"}]}
interface	{"input":[{"name":"files","type":"array","description":"要審查的檔案路徑列表","required":true},{"name":"review_type","type":"string","description":"審查類型：full, security, performance, quick","required":false,"default":"full"},{"name":"context","type":"object","description":"額外上下文（如變更原因）","required":false}],"output":[{"name":"review_result","type":"object","description":"審查結果"},{"name":"issues","type":"array","description":"發現的問題列表"},{"name":"next_action","type":"string","description":"建議的下一步"}]}
triggers	[{"pattern":"程式碼審查","description":"需要審查程式碼時"},{"pattern":"Milestone 完成","description":"Milestone 完成後自動審查"},{"pattern":"提交前","description":"git commit 前審查"}]

Code Reviewer

審查程式碼 → 找出問題 → 提供建議

核心理念

┌─────────────────────────────────────────────────────────────────┐
│  不重複造輪子，直接使用 PAL MCP 的專業審查能力                  │
│                                                                 │
│  本 Skill 職責：                                                │
│  • 定義何時觸發審查                                             │
│  • 準備審查所需的上下文                                         │
│  • 整理審查結果                                                 │
│  • 與其他 Skill 協作                                            │
└─────────────────────────────────────────────────────────────────┘

使用方式

基本審查

// 調用 PAL codereview
await mcp__pal__codereview({
  step: "審查 M1 完成的程式碼",
  step_number: 1,
  total_steps: 2,
  next_step_required: true,
  findings: "初始審查",
  relevant_files: [
    "/path/to/file1.js",
    "/path/to/file2.js"
  ],
  review_type: "full",
  model: "gemini-2.5-pro"
})

審查類型

類型	說明	適用時機
full	完整審查（品質、安全、效能、架構）	Milestone 完成後
security	安全專項審查	處理敏感資料時
performance	效能專項審查	優化相關變更
quick	快速審查	小幅修改

審查標準

PAL codereview 會檢查：

品質 (Quality)：
• 程式碼可讀性
• 命名規範
• 註解完整性
• 錯誤處理

安全 (Security)：
• 輸入驗證
• SQL 注入
• XSS 防護
• 敏感資料處理

效能 (Performance)：
• 複雜度分析
• 資源使用
• 快取策略
• N+1 問題

架構 (Architecture)：
• 設計模式
• 模組化程度
• 依賴管理
• 可維護性

審查流程

┌─────────────────────────────────────────────────────────────────┐
│  1. 收集檔案列表                                                │
│     → 從 plan 或手動指定要審查的檔案                            │
│                                                                 │
│  2. 準備上下文                                                  │
│     → 變更原因、相關需求、已知限制                              │
│                                                                 │
│  3. 調用 PAL codereview                                         │
│     → 執行審查，取得結果                                        │
│                                                                 │
│  4. 整理結果                                                    │
│     → 按嚴重程度排序問題                                        │
│                                                                 │
│  5. 輸出建議                                                    │
│     → 需要修正的問題、改進建議                                  │
└─────────────────────────────────────────────────────────────────┘