Cursor 入門實作：用 Agent 實現程式碼規範自動化

本次實測針對一個單純 Python 為主的 side project(約莫20支.py左右)，主要任務為 API endpoint 的 docstring 補齊與 PEP 8 命名規範統一。整體修改集中於命名與註解層級，並未涉及業務邏輯調整，實際 token 成本約為 10 元台幣等值。

前言

大家好，許久未見了 在這邊先祝大家2026新年快樂

其實自ChatGPT橫空出世以來，最近幾年又開始出現各類AI Agent， Vibe Coding的概念越發盛行

包含Github Copilot、Claude Code 以及本次要介紹的 Cursor

Cursor 是一個基於 VS Code 的 AI 代碼編輯器，由 Anysphere 團隊開發，內建強大的 AI 功能（如自動補全、Agent、Composer、Bugbot 等），被許多工程師稱為「AI 版的 VS Code」

它最大的特色是能深度理解整個專案上下文，讓 AI 不只補全，還能主動執行多檔重構、code review 等任務

當Python遇上亂用C#、Java命名規則的我

剛好我最近 side project 寫到一個段落，是個 Line 梗圖機器人

為前後端分離架構，分別是Vue3配上python 的 FastAPI

以往有看我文章的人應該知道，Python算是我的第三語言 (或許跟JS同等級)

所以我帶了不少C#、Java的命名習慣過來，有時候又搬了GPT、Gemini的程式過來

程式碼就變得很混亂，儘管我會偶爾自己手動清除，但還是埋下了不少地雷

前陣子本來打算自己呼叫 Python 一個叫 Ruff(*註1) 的套件來掃描，是個基於Rust撰寫的程式碼分析工具

但想了想，有點小偷懶，決定下次再用那個

這次順便來試試看 Cursor 能不能幫我依照 PEP 8(*註2) 的python命名規範來修改

簡單下了如此指令，再來等待等待一下

可以看到的是他不只改了Python檔，甚至還自己建立了問題清單

下面可以看到本次動到的檔案，點擊更可以看到本次改動 (因為我keep了好幾筆檔案才想到寫文章，所以只剩3個了)

我們來簡單點一個看看

可以看到他遵照PEP 8的規範，最上面引用的 Class 採 PascalCase 也就是首個字母大寫其餘小寫不使用底線的

再來就是他幫我補充的 API 說明 (啊..這個API剛好是少數我本來就有寫的，所以可以看到差異)

可以看到非常容易使用，第一個偏上紅框也就是diff的地方，可以選擇 Undo (撤銷) 或是 Keep (保留)

當然如果你懶得一個一個點擊，當然要再確認完之後，你也可以直接點擊最下方的 Keep All

這就會一口氣保留所有的變更

第一次主要是幫我修正了API endpoint的docstring 但有一些類別他都是列出來，於是這邊再下一次指令讓他協助修改

變更報告、檔案一覽與Token花費

於是他修正完後甚至產了一份報告出來哈哈，連我英文單字拼錯都被抓出來了

最後我們來看一下總共變更(不包含修正報告)

共9個檔案，一部分也是因為這個sideproject不大，又限制了他修改的範圍

⭐然後看一下花費Token方面，兩次呼叫加總約為 0.32 塊美金，也就是約莫新台幣10塊

10塊台幣就能省下不少時間，我覺得還是相對划算的

畢竟單論尋找以及修正，我覺得我快的話至少也要花費個十來分鐘

當然也是因為我現在是免費模式，真的付費可能就不會讓他特別做這種事情啦哈哈

結論

這次用起 Cursor 還是頗震撼的，以往的你問我答AI 已經進化到可以理解上下文

像是這次給Cursor交代的任務也是較為單純，畢竟PEP8的規範比較明確，API endpoint的功能也都相對單純

之後會嘗試將一些功能讓他去與vue同步實作

*註1 : Ruff 官網

*註2 : PEP 8 – Style Guide for Python Code | peps.python.org

🧡希望這篇文章有提供一點幫助~

🧡幫我點一個小小的廣告或留言，都是對我的支持!

⭐如有任何疑問，歡迎透過留言或messenger讓我知道 !

🍽️另外，徵求任何合作機會(不管是業配、廣告或是友站連結)

看看一些其他的文章吧