前端程式碼審查
目的
當使用者要求審查前端程式碼(特別是 .tsx、.ts 或 .js 檔案)時,使用此技能。支援兩種審查模式:
- 待變更審查 – 檢查已暫存或工作目錄中準備送交的檔案,在提交前標記檢查清單違規。
- 指定檔案審查 – 審查使用者指定的特定檔案,並報告相關的檢查清單結果。
對於每個適用的檔案與模式,請一律遵循下面的檢查清單。
檢查清單
請參閱 references/code-quality.md、references/performance.md、references/business-logic.md 以取得按類別分類的最新檢查清單——將其視為應遵循的權威規則集。
每個違規規則都應標記緊急程度元數據,以便未來審查者能優先處理修復。
審查流程
- 開啟相關元件/模組。收集與類別名稱、React Flow 鉤子、屬性記憶化及樣式相關的程式行。
- 針對審查要點中的每一條規則,記錄程式碼偏離之處並擷取代表性程式片段。
- 按照下方的模板撰寫審查區塊。首先依「緊急」標記分組,然後依類別順序(程式碼品質、效能、商業邏輯)排列。
必要輸出
呼叫時,回應必須嚴格遵循以下兩種模板之一:
模板 A(有發現問題)
# 程式碼審查
發現 <N> 個需要修復的緊急問題:
## 1 <問題簡短描述>
檔案路徑:<路徑> 第 <行> 行
<相關程式碼片段或指引>
### 建議修正
<建議修正的簡短描述>
---
...(對每個緊急問題重複)...
發現 <M> 個改善建議:
## 1 <建議簡短描述>
檔案路徑:<路徑> 第 <行> 行
<相關程式碼片段或指引>
### 建議修正
<建議修正的簡短描述>
---
...(對每個建議重複)...
如果沒有緊急問題,則省略該區段。如果沒有改善建議,則省略該區段。
如果問題編號超過 10 個,則總結為「10+ 個緊急問題」或「10+ 個建議」,並僅輸出前 10 個問題。
請勿壓縮區段之間的空行;為保持可讀性,請保留原樣。
如果你使用了模板 A(亦即有需要修正的問題),且至少有一個問題需要程式碼變更,請在結構化輸出後附加一個簡短的追問,詢問使用者是否希望套用建議的修正。例如:「您是否希望我根據『建議修正』區段來處理這些問題?」
模板 B(沒有問題)
## 程式碼審查
未發現任何問題。