使用 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 操作模式。

vocus|新世代的創作平台

接著輸入:

請幫我列出目前分支與 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
湯編驛-湯姆實驗室
38會員
82內容數
這邊會放一些我自己的分享內容,實驗測試還有做的MVP介紹
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
權限管理=新增、修改、刪除+審核 通常,這種程式的設計會包含權限管理,其中包括現場修改、刪除等三大類功能。然而,根據經驗,我們還需要關注另一類功能,即審核權限。 審核不執行新增 審核權限通常不執行新增的動作,僅限於某些欄位的輸入。新增、修改、刪除這些操作基本上是容易理解的。也就是說,對於這個工
Thumbnail
權限管理=新增、修改、刪除+審核 通常,這種程式的設計會包含權限管理,其中包括現場修改、刪除等三大類功能。然而,根據經驗,我們還需要關注另一類功能,即審核權限。 審核不執行新增 審核權限通常不執行新增的動作,僅限於某些欄位的輸入。新增、修改、刪除這些操作基本上是容易理解的。也就是說,對於這個工
Thumbnail
本篇文章介紹如何使用Git Bash進行版本控制操作,包括創建repository、查看狀態、歷程以及加入暫存和提交暫存等操作。透過基本的Git指令,您可以更深入地瞭解Git工具的使用方法。
Thumbnail
本篇文章介紹如何使用Git Bash進行版本控制操作,包括創建repository、查看狀態、歷程以及加入暫存和提交暫存等操作。透過基本的Git指令,您可以更深入地瞭解Git工具的使用方法。
Thumbnail
Visual Basic for Applications(VBA)是一種功能強大的程式語言,廣泛用於自動化 Microsoft Office 應用程式中的重複性任務。在這篇教學文章中,我們將介紹如何使用 VBA 來新增、刪除和移動檔案。
Thumbnail
Visual Basic for Applications(VBA)是一種功能強大的程式語言,廣泛用於自動化 Microsoft Office 應用程式中的重複性任務。在這篇教學文章中,我們將介紹如何使用 VBA 來新增、刪除和移動檔案。
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
列出一套完整的程式 程式設計有許多種方法,不過通常會先列出清單的再逐一執行,這樣會加快程式設計的速度。設計通常會採取順推的辦法。所以順推的程式設計方式就是經歷觀念溝通、系統分析、資料統合、權限管理、頻率與時間、後台管理、畫面設計等等階段後,將框架設計完了以後,先列出一套完整的程式,將所有使用者都確
Thumbnail
列出一套完整的程式 程式設計有許多種方法,不過通常會先列出清單的再逐一執行,這樣會加快程式設計的速度。設計通常會採取順推的辦法。所以順推的程式設計方式就是經歷觀念溝通、系統分析、資料統合、權限管理、頻率與時間、後台管理、畫面設計等等階段後,將框架設計完了以後,先列出一套完整的程式,將所有使用者都確
Thumbnail
工具功能 (1) 彈性任意查詢檔案,如對來源目錄設定,檔案修改日期 設定,檔名特定字串或副檔名設定後,自動查出明細,並可展開至各階子目錄處理     (2) 依查詢後結果,可產出 LIST ,提供查詢結果之確認,再依此對檔案作複 (3) 可對檔案作移動,複製至別處,刪除處理,使電腦可騰出硬碟空間
Thumbnail
工具功能 (1) 彈性任意查詢檔案,如對來源目錄設定,檔案修改日期 設定,檔名特定字串或副檔名設定後,自動查出明細,並可展開至各階子目錄處理     (2) 依查詢後結果,可產出 LIST ,提供查詢結果之確認,再依此對檔案作複 (3) 可對檔案作移動,複製至別處,刪除處理,使電腦可騰出硬碟空間
Thumbnail
本篇將分享VSCode工作區的設定與功能,包括如何將資料夾新增到工作區、如何存檔、以及外掛推薦。這些小技巧能夠幫助您在使用 rushjs 能更輕鬆地管理 monorepo,提高工作效率。
Thumbnail
本篇將分享VSCode工作區的設定與功能,包括如何將資料夾新增到工作區、如何存檔、以及外掛推薦。這些小技巧能夠幫助您在使用 rushjs 能更輕鬆地管理 monorepo,提高工作效率。
Thumbnail
本文分析導演巴里・柯斯基(Barrie Kosky)如何運用極簡的舞臺配置,將布萊希特(Bertolt Brecht)的「疏離效果」轉化為視覺奇觀與黑色幽默,探討《三便士歌劇》在當代劇場中的新詮釋,並藉由舞臺、燈光、服裝、音樂等多方面,分析該作如何在保留批判核心的同時,觸及觀眾的觀看位置與人性幽微。
Thumbnail
本文分析導演巴里・柯斯基(Barrie Kosky)如何運用極簡的舞臺配置,將布萊希特(Bertolt Brecht)的「疏離效果」轉化為視覺奇觀與黑色幽默,探討《三便士歌劇》在當代劇場中的新詮釋,並藉由舞臺、燈光、服裝、音樂等多方面,分析該作如何在保留批判核心的同時,觸及觀眾的觀看位置與人性幽微。
Thumbnail
《轉轉生》(Re:INCARNATION)為奈及利亞編舞家庫德斯.奧尼奎庫與 Q 舞團創作的當代舞蹈作品,結合拉各斯街頭節奏、Afrobeat/Afrobeats、以及約魯巴宇宙觀的非線性時間,建構出關於輪迴的「誕生—死亡—重生」儀式結構。本文將從約魯巴哲學概念出發,解析其去殖民的身體政治。
Thumbnail
《轉轉生》(Re:INCARNATION)為奈及利亞編舞家庫德斯.奧尼奎庫與 Q 舞團創作的當代舞蹈作品,結合拉各斯街頭節奏、Afrobeat/Afrobeats、以及約魯巴宇宙觀的非線性時間,建構出關於輪迴的「誕生—死亡—重生」儀式結構。本文將從約魯巴哲學概念出發,解析其去殖民的身體政治。
Thumbnail
5 月將於臺北表演藝術中心映演的「2026 北藝嚴選」《海妲・蓋柏樂》,由臺灣劇團「晃晃跨幅町」製作,本文將以從舞台符號、聲音與表演調度切入,討論海妲・蓋柏樂在父權社會結構下的困境,並結合榮格心理學與馮.法蘭茲對「阿尼姆斯」與「永恆少年」原型的分析,理解女人何以走向精神性的操控、毀滅與死亡。
Thumbnail
5 月將於臺北表演藝術中心映演的「2026 北藝嚴選」《海妲・蓋柏樂》,由臺灣劇團「晃晃跨幅町」製作,本文將以從舞台符號、聲音與表演調度切入,討論海妲・蓋柏樂在父權社會結構下的困境,並結合榮格心理學與馮.法蘭茲對「阿尼姆斯」與「永恆少年」原型的分析,理解女人何以走向精神性的操控、毀滅與死亡。
Thumbnail
透過 No Code 自動化建立「待辦事項 AI 助理」,你只要上傳語音檔在 LINE 聊天室,AI 即自動摘要語音內容,同時新增待辦事項在 Todoist 待辦事項 APP,讓你管理任務更輕鬆!即使臨時接收口頭任務交付,或當下忙著處理別的事情,也能輕鬆建立待辦事項!
Thumbnail
透過 No Code 自動化建立「待辦事項 AI 助理」,你只要上傳語音檔在 LINE 聊天室,AI 即自動摘要語音內容,同時新增待辦事項在 Todoist 待辦事項 APP,讓你管理任務更輕鬆!即使臨時接收口頭任務交付,或當下忙著處理別的事情,也能輕鬆建立待辦事項!
Thumbnail
這是一場修復文化與重建精神的儀式,觀眾不需要完全看懂《遊林驚夢:巧遇Hagay》,但你能感受心與土地團聚的渴望,也不急著在此處釐清或定義什麼,但你的在場感受,就是一條線索,關於如何找著自己的路徑、自己的聲音。
Thumbnail
這是一場修復文化與重建精神的儀式,觀眾不需要完全看懂《遊林驚夢:巧遇Hagay》,但你能感受心與土地團聚的渴望,也不急著在此處釐清或定義什麼,但你的在場感受,就是一條線索,關於如何找著自己的路徑、自己的聲音。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News