在我們團隊,每次修改程式碼時,有個算是過時的規定吧:所有被修改的檔案,都要在檔案最上方的註解區塊加上修改日期與修改者名稱,格式大致如下:
/**
* 系統-子系統-模組-功能
* ACC: Tom, Luna
* Modified: 2025/08/06 Tom. <<< 加上這個
*/
對,我知道這樣很蠢,這種做法在現在這個年代已經過時,因為 Git 本來就有版本紀錄,不但能精準顯示檔案何時被修改,甚至連哪一行是誰改的都查得出來。用這種人工補註解的方式,除了麻煩,還容易忘記。
不過,工作就是這樣,有些事情你不想做,不代表你可以不做,老闆想要什麽給他就是了。我今天想分享的,不是要和大家說這個規定有多沒意義,而是當你真的不小心忘記加上 Modified
註解,然後 PR 已經動到了三十幾個檔案的情況下,你該怎麼處理?難道只能手動一個一個補回去嗎?
至於為什麼有這種規定,有興趣了解更多的可以看一下 如何判斷一個工程師程式碼是否寫得好?「主責檔案」的奇特方法。瞭解更多。
利用 Cursor 幫你自動補 Modified
這邊推薦一個更聰明的做法——使用 這類 AI 工具來幫忙完成這件事。
Cursor 是一個整合 AI 助理的 VSCode 分支版本,支援與 Git、Terminal 整合,可以直接跟它互動請求協助。
Step 1:先讓 Cursor 知道你要操作 Git
在 Cursor 的對話視窗中,輸入 @git
,讓它進入 Git 操作模式。

接著輸入:
請幫我列出目前分支與 master 分支比較起來,有哪些檔案被修改過
它會幫你列出目前修改過的檔案,例如(以下為模擬範例):
以下是你有修改的檔案:
- src/utils/math.ts
- src/pages/LoginPage.tsx
- src/components/Button.tsx
其實它背後就是幫你下了 git diff --name-only master
,但你不用自己打指令。
Step 2:請 AI 幫你在每個檔案加上註解
接著再給 Cursor 下指令:
請幫我在上面這些檔案的註解區,新增Modified:2025/08/06Tom
Cursor 會逐一打開這些檔案,在註解區塊中補上對應的修改資訊,格式一致,也不會漏掉任何檔案。整個過程只需幾秒,效率大大提升。
操作步驟總結
- 開啟 Cursor 專案,進入對話視窗
- 輸入
@git
,查出這個分支與 master 的差異(終端機執行git diff --name-only master
) - 要求 AI 幫忙在這些檔案最上方註解區加上
Modified: yyyy/mm/dd 名字
- 儲存、檢查並 Commit
結語:AI 不只會寫程式,也能幫你處理重複性的工作
像這種補註解的作業,其實很適合交由工具自動化處理。如果不是流程上有特別的規定,手動處理這類重複性工作容易耗時又容易出錯。既然現在有 AI 工具可以輔助,不妨善用它的能力來提升工作效率。
AI 不只在寫程式上能幫上忙,對於這種需要統一格式、批次修改的情境,也很有幫助。只要說清楚需求,它就能幫你處理好,減少手動操作的負擔,讓你可以把時間花在更重要的開發工作上。
下次遇到類似「重複處理很多檔案」的狀況,可以考慮交給 AI 幫你做做看。說明清楚規則,它就能一口氣幫你處理好,少掉很多手動打開檔案的時間。
不一定要全部自動化,但能少做一點,就少做一點。工程師就是能偷懶就偷懶。
歡迎留言分享
你們遇到類似流程時會怎麼處理? 有其他自動化的小技巧也歡迎交流!