Day 9:幫 AI 的改動分級:為什麼「要不要開 PR」是錯的判準
A/B/C/D 量可見度、Sec 量風險,兩條獨立的軸標在 commit trailer 裡
這份知識精煉摘要探討在與AI協同開發時,如何有效分類大量的程式碼改動。作者指出,傳統以「是否開PR」作為判準的A/B/C分級方式存在流程與規模不對應、以及遺漏「使用者看不到但極為重要」修復的兩大問題。文章提出一套以「對使用者的可見度」為核心的四級(A/B/C/D)分類系統,並強調資安應獨立為一條軸線進行評估。此方法旨在確保開發團隊能精確識別並溝通改動的影響範圍與風險,尤其是不易察覺的潛在問題,並建議將這些分級資訊永久記錄於Git commit中,而非短暫的對話紀錄。適合軟體開發者、專案經理及技術主管。
重點摘要
- 傳統以「是否開PR」判斷改動大小的方式,無法反映實際影響與風險。
- 一行文字的改動可能比新增一個頁面具有更大的「爆炸半徑」。
- 「使用者看不到的修復」如資料外洩、效能問題,是傳統分級最容易被忽略的關鍵。
- 建議採用以「對使用者的可見度」為判準的A/B/C/D四級分類系統。
- 資安風險應獨立於可見度分級,作為一條獨立的軸線進行評估。
- 將改動分級與資安風險標記永久記錄在Git commit中,而非對話紀錄。
- Commit前綴(如feat、fix)無法準確推測改動對使用者的影響等級。
章節
傳統分級的盲點:PR流程與規模不對應
作者指出以「是否開PR」分級的直覺方式,可能導致一行文字的改動比新頁面影響更大。
更嚴重的問題:看不見的修復被忽略
傳統A/B/C分級無法涵蓋使用者看不到,但影響系統穩定性與資安的關鍵修復。
提出新四級分級:以使用者可見度為判準
介紹以「使用者感受」為核心的A(新增功能)、B(行為改變)、C(外觀文字)、D(使用者看不到)四級分類。
資安獨立評估:不與可見度混淆
強調資安應作為獨立軸線,以其「風險大小與急迫性」而非可見度來評估,並提供嚴重度判準。
將分級永久記錄於Commit中
建議將分級資訊標註在Git commit的trailer中,確保其客觀性、跨session與可追溯性,並提供查詢範例。
為何不能自動推測Commit前綴
解釋Commit前綴(如feat/fix)與實際使用者影響等級不符,無法自動推測,需人工標註。
核心理念:誰會受影響才是判準
總結分級的核心在於「誰會受影響」,並強調使用者看不到的D級重要性。
適合對象:軟體開發者、專案經理、技術主管以及任何需要管理程式碼改動與風險評估的團隊領導者。