與 AI Agent 協作的小秘訣

又來分享一點 Antigravity 的使用心得,很簡短的。


這算是上一篇文章〈我用一週 Antigravity 的心得:為何評價兩極?〉的後續補充。


適合對象:剛開始使用 AI agent 的人。


上週我推薦 Antigravity 給一位朋友,後來收到的 feedback 是:


他只是讓 agent 改了一個小功能,程式碼改了,執行後卻完全沒有作用,且怎麼改都不對。


剛好我最近跟 Antigravity 一起處理的專案告一段落(新版 release note、文件網站幾乎都是它寫的),有點空檔,就問朋友,如果依然卡住,要不要讓我試試看。


結果收到他的 .NET 專案後,從我打開 Antigravity、下第一個指令,到完成功能修改為止,大概 10 分鐘就改好了。其實真的只是個小改動。


朋友測試完說:「完美!它改了什麼?」


我把我跟 AI 的一些對話截圖貼給他,並說:

「Antigravity 生成的 walkthrough 文件,我讓它整理好放在專案的 doc 子目錄裡了,可以看那個文件來瞭解實作細節。」


然後,我也問了他當初是怎麼給 AI 下指示的。


原來問題在於——提示詞的寫法


我不能分享他的專案內容,但可以分享我給他的建議:


🧩 起手式:AI 介入 brownfield 專案時

第一個指令我通常會這樣下:

請閱讀整個專案,整理你對其架構、功能、技術堆疊等理解,並輸出成 AGENT_CONTEXT.md 置於根目錄。


接著可以請它找出可改進之處,或直接和它討論要修改的功能。


🧑‍💻 協作心態

不要把 agent 當神仙或算命師。


一句含糊的描述就期待它完全理解、完美實作,很多時候是不可能的。


請把它當作一起合作寫程式的工程師:

  • 先確認它是否理解需求。
  • 理解一致後,討論怎麼改。
  • 你也可以先講你的想法,然後問它:「你覺得呢?」
  • 讓它提出方案,由你挑一個最合適的。
  • 接著讓它寫實作計畫,由你 review。
  • 沒問題後,說:Proceed,讓 agent 動手實作。
  • 實作完成後,由你測試和 review code。


參考下圖,是我在 Antigravity 中與 AI agent 對話的其中一部分:




以上,小小心得。希望對開始用 agent 寫程式的人有幫助。


Keep coding with AI 🤖

沒有留言:

技術提供:Blogger.
回頂端⬆️