使用 AI 工具 Cursor 自動化程式碼檔案修改註解

更新 發佈閱讀 4 分鐘

在我們團隊,每次修改程式碼時,有個算是過時的規定吧:所有被修改的檔案,都要在檔案最上方的註解區塊加上修改日期與修改者名稱,格式大致如下:

/**
* 系統-子系統-模組-功能
* 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 操作模式。

raw-image

接著輸入:

請幫我列出目前分支與 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 會逐一打開這些檔案,在註解區塊中補上對應的修改資訊,格式一致,也不會漏掉任何檔案。整個過程只需幾秒,效率大大提升。

操作步驟總結

  1. 開啟 Cursor 專案,進入對話視窗
  2. 輸入 @git,查出這個分支與 master 的差異(終端機執行 git diff --name-only master
  3. 要求 AI 幫忙在這些檔案最上方註解區加上 Modified: yyyy/mm/dd 名字
  4. 儲存、檢查並 Commit

結語:AI 不只會寫程式,也能幫你處理重複性的工作

像這種補註解的作業,其實很適合交由工具自動化處理。如果不是流程上有特別的規定,手動處理這類重複性工作容易耗時又容易出錯。既然現在有 AI 工具可以輔助,不妨善用它的能力來提升工作效率。

AI 不只在寫程式上能幫上忙,對於這種需要統一格式、批次修改的情境,也很有幫助。只要說清楚需求,它就能幫你處理好,減少手動操作的負擔,讓你可以把時間花在更重要的開發工作上。

下次遇到類似「重複處理很多檔案」的狀況,可以考慮交給 AI 幫你做做看。說明清楚規則,它就能一口氣幫你處理好,少掉很多手動打開檔案的時間。

不一定要全部自動化,但能少做一點,就少做一點。工程師就是能偷懶就偷懶。


歡迎留言分享

你們遇到類似流程時會怎麼處理? 有其他自動化的小技巧也歡迎交流!

留言
avatar-img
留言分享你的想法!
avatar-img
Tom的沙龍
13會員
47內容數
我是一個從科技業轉職的軟體工程師
Tom的沙龍的其他內容
2025/08/03
一位不懂AI卻強迫員工使用AI工具的主管,引發作者反思AI工具的正確使用方式與主管的學習態度。文章以自身經驗出發,探討AI工具應以解決問題為導向,而非盲目跟風,並呼籲主管應以開放的心態與團隊共同學習成長。
Thumbnail
2025/08/03
一位不懂AI卻強迫員工使用AI工具的主管,引發作者反思AI工具的正確使用方式與主管的學習態度。文章以自身經驗出發,探討AI工具應以解決問題為導向,而非盲目跟風,並呼籲主管應以開放的心態與團隊共同學習成長。
Thumbnail
2025/07/31
本文探討臺灣職場常見的「績效威脅」問題,說明主管如何利用制度漏洞,以獎金或考績作為手段,變相霸凌員工,以及現行法律對此類問題的不足之處。文章並提供員工自保建議,例如:蒐集證據、瞭解相關法律規範、尋求支持等,最後呼籲社會應重視此問題,並期盼法律能完善相關法規,以保障勞工權益。
Thumbnail
2025/07/31
本文探討臺灣職場常見的「績效威脅」問題,說明主管如何利用制度漏洞,以獎金或考績作為手段,變相霸凌員工,以及現行法律對此類問題的不足之處。文章並提供員工自保建議,例如:蒐集證據、瞭解相關法律規範、尋求支持等,最後呼籲社會應重視此問題,並期盼法律能完善相關法規,以保障勞工權益。
Thumbnail
2025/07/25
主管查得經常追問員工請假原因,甚至涉及隱私,引發員工不滿。本文分析查得行為背後的可能心理因素,並從個人資料保護法、性別工作平等法、民法等面向探討其行為的法律責任,最後提供員工因應之道,包含保持沉默、私下溝通、尋求HR協助等,呼籲職場應尊重員工隱私。
Thumbnail
2025/07/25
主管查得經常追問員工請假原因,甚至涉及隱私,引發員工不滿。本文分析查得行為背後的可能心理因素,並從個人資料保護法、性別工作平等法、民法等面向探討其行為的法律責任,最後提供員工因應之道,包含保持沉默、私下溝通、尋求HR協助等,呼籲職場應尊重員工隱私。
Thumbnail
看更多
你可能也想看
Thumbnail
蝦皮分潤計畫讓我在分享旅遊文章時,也能透過推薦好物累積被動收入,貼補旅行基金。這篇文章,除了介紹計畫的操作亮點與心得,也分享我最常應用的案例:「旅行必備小物 TOP5」,包含行李鎖、免洗內衣褲、分裝瓶、折疊衣架與真空壓縮袋,幫助出國打包更輕鬆。想同時記錄旅行、分享好物又創造額外收入的你,千萬別錯過!
Thumbnail
蝦皮分潤計畫讓我在分享旅遊文章時,也能透過推薦好物累積被動收入,貼補旅行基金。這篇文章,除了介紹計畫的操作亮點與心得,也分享我最常應用的案例:「旅行必備小物 TOP5」,包含行李鎖、免洗內衣褲、分裝瓶、折疊衣架與真空壓縮袋,幫助出國打包更輕鬆。想同時記錄旅行、分享好物又創造額外收入的你,千萬別錯過!
Thumbnail
想增加被動收入?加入蝦皮分潤計畫是輕鬆上手的好方法!本文提供完整教學,包含申請流程、賺取分潤技巧,以及實際使用心得分享,助你輕鬆獲得額外收入。
Thumbnail
想增加被動收入?加入蝦皮分潤計畫是輕鬆上手的好方法!本文提供完整教學,包含申請流程、賺取分潤技巧,以及實際使用心得分享,助你輕鬆獲得額外收入。
Thumbnail
透過 No Code 自動化建立「待辦事項 AI 助理」,你只要上傳語音檔在 LINE 聊天室,AI 即自動摘要語音內容,同時新增待辦事項在 Todoist 待辦事項 APP,讓你管理任務更輕鬆!即使臨時接收口頭任務交付,或當下忙著處理別的事情,也能輕鬆建立待辦事項!
Thumbnail
透過 No Code 自動化建立「待辦事項 AI 助理」,你只要上傳語音檔在 LINE 聊天室,AI 即自動摘要語音內容,同時新增待辦事項在 Todoist 待辦事項 APP,讓你管理任務更輕鬆!即使臨時接收口頭任務交付,或當下忙著處理別的事情,也能輕鬆建立待辦事項!
Thumbnail
Visual Basic for Applications(VBA)是一種功能強大的程式語言,廣泛用於自動化 Microsoft Office 應用程式中的重複性任務。在這篇教學文章中,我們將介紹如何使用 VBA 來新增、刪除和移動檔案。
Thumbnail
Visual Basic for Applications(VBA)是一種功能強大的程式語言,廣泛用於自動化 Microsoft Office 應用程式中的重複性任務。在這篇教學文章中,我們將介紹如何使用 VBA 來新增、刪除和移動檔案。
Thumbnail
工具功能 (1) 彈性任意查詢檔案,如對來源目錄設定,檔案修改日期 設定,檔名特定字串或副檔名設定後,自動查出明細,並可展開至各階子目錄處理     (2) 依查詢後結果,可產出 LIST ,提供查詢結果之確認,再依此對檔案作複 (3) 可對檔案作移動,複製至別處,刪除處理,使電腦可騰出硬碟空間
Thumbnail
工具功能 (1) 彈性任意查詢檔案,如對來源目錄設定,檔案修改日期 設定,檔名特定字串或副檔名設定後,自動查出明細,並可展開至各階子目錄處理     (2) 依查詢後結果,可產出 LIST ,提供查詢結果之確認,再依此對檔案作複 (3) 可對檔案作移動,複製至別處,刪除處理,使電腦可騰出硬碟空間
Thumbnail
因為最近想嘗試編碼風格,於是就選了一套比較"不嚴格"的輔助工具來摸索。 編輯器 VS CODE 框架 VUE3 打包工具 VITE 編碼風格 Standard 環境 version { "nodejs":"v18.18.0", "npm":"9.8.1" }
Thumbnail
因為最近想嘗試編碼風格,於是就選了一套比較"不嚴格"的輔助工具來摸索。 編輯器 VS CODE 框架 VUE3 打包工具 VITE 編碼風格 Standard 環境 version { "nodejs":"v18.18.0", "npm":"9.8.1" }
Thumbnail
本篇文章介紹如何使用Git Bash進行版本控制操作,包括創建repository、查看狀態、歷程以及加入暫存和提交暫存等操作。透過基本的Git指令,您可以更深入地瞭解Git工具的使用方法。
Thumbnail
本篇文章介紹如何使用Git Bash進行版本控制操作,包括創建repository、查看狀態、歷程以及加入暫存和提交暫存等操作。透過基本的Git指令,您可以更深入地瞭解Git工具的使用方法。
Thumbnail
本篇將分享VSCode工作區的設定與功能,包括如何將資料夾新增到工作區、如何存檔、以及外掛推薦。這些小技巧能夠幫助您在使用 rushjs 能更輕鬆地管理 monorepo,提高工作效率。
Thumbnail
本篇將分享VSCode工作區的設定與功能,包括如何將資料夾新增到工作區、如何存檔、以及外掛推薦。這些小技巧能夠幫助您在使用 rushjs 能更輕鬆地管理 monorepo,提高工作效率。
Thumbnail
列出一套完整的程式 程式設計有許多種方法,不過通常會先列出清單的再逐一執行,這樣會加快程式設計的速度。設計通常會採取順推的辦法。所以順推的程式設計方式就是經歷觀念溝通、系統分析、資料統合、權限管理、頻率與時間、後台管理、畫面設計等等階段後,將框架設計完了以後,先列出一套完整的程式,將所有使用者都確
Thumbnail
列出一套完整的程式 程式設計有許多種方法,不過通常會先列出清單的再逐一執行,這樣會加快程式設計的速度。設計通常會採取順推的辦法。所以順推的程式設計方式就是經歷觀念溝通、系統分析、資料統合、權限管理、頻率與時間、後台管理、畫面設計等等階段後,將框架設計完了以後,先列出一套完整的程式,將所有使用者都確
Thumbnail
權限管理=新增、修改、刪除+審核 通常,這種程式的設計會包含權限管理,其中包括現場修改、刪除等三大類功能。然而,根據經驗,我們還需要關注另一類功能,即審核權限。 審核不執行新增 審核權限通常不執行新增的動作,僅限於某些欄位的輸入。新增、修改、刪除這些操作基本上是容易理解的。也就是說,對於這個工
Thumbnail
權限管理=新增、修改、刪除+審核 通常,這種程式的設計會包含權限管理,其中包括現場修改、刪除等三大類功能。然而,根據經驗,我們還需要關注另一類功能,即審核權限。 審核不執行新增 審核權限通常不執行新增的動作,僅限於某些欄位的輸入。新增、修改、刪除這些操作基本上是容易理解的。也就是說,對於這個工
Thumbnail
資料庫之備份工作大都是自動執行,但是執行結果是否成功,需要安排人員去檢查,有時疏忽忘記確認作業,致備份工作失敗仍不知道,等到有一天需要回復舊有資料的場合時,才發現找不到過去某段期間的備份資料,造成無法彌補之後果。   2.    改善: 2.1 設計一執行檔,功能為打開備
Thumbnail
資料庫之備份工作大都是自動執行,但是執行結果是否成功,需要安排人員去檢查,有時疏忽忘記確認作業,致備份工作失敗仍不知道,等到有一天需要回復舊有資料的場合時,才發現找不到過去某段期間的備份資料,造成無法彌補之後果。   2.    改善: 2.1 設計一執行檔,功能為打開備
Thumbnail
Plus 一款能替你的 Notion 增色不少的外掛工具,讓你可以更進一步地定制和優化你的工作與學習流程。在這篇教學中,我將向你介紹如何使用 Plus ,並推薦三個可以融入你工作流程的小工具,包括擁有紐約時報每日最新消息畫面、擷取試算表圖表,以及如何透過 Plus AI 為你自動化地生成簡報。
Thumbnail
Plus 一款能替你的 Notion 增色不少的外掛工具,讓你可以更進一步地定制和優化你的工作與學習流程。在這篇教學中,我將向你介紹如何使用 Plus ,並推薦三個可以融入你工作流程的小工具,包括擁有紐約時報每日最新消息畫面、擷取試算表圖表,以及如何透過 Plus AI 為你自動化地生成簡報。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News