iT邦幫忙

2026 iThome 鐵人賽

DAY 12
0
Vibe Coding

人機協同程式開發實戰:用 AI 輔助開發 Swift 與 Spring Boot,打造屬於自己的程式系列 第 12 篇

Day 12 — Codex 提示詞心法:精準控制強大模型的四大注意事項

  • 分享至 

  • xImage
  •  

昨天的實戰中,我們體驗了 Codex 精準的 Codebase 讀取與前後端統合能力。然而,正因為 Codex 底層使用的是 ChatGPT 這種極大規模的語言模型(LLM),如果下達 Prompt 時不夠嚴謹,它可能會過度發揮「創造力」,產生出不符合專案規範的程式碼。

今天我們就來盤點在 Xcode 與 IntelliJ IDEA 中使用 Codex 時,下達 Prompt 必須留意的四大關鍵注意事項!


1. 明確指定範圍,避免過度改動(Keep Scope Confined)

Codex 具備讀取整個專案的能力,但這也是一把雙刃劍。若指令沒有明確限制,它可能會順便「幫你重構」其他不需要修改的檔案。

  • 地雷寫法:「幫我優化 User 模組的程式碼。」
  • 正確做法:「請僅針對 UserService.java 中的 register 函式進行重構,不要修改其他方法與 UserController.java。」

2. 強制約束程式碼風格與技術規格(Define Constraints)

不同專案有不同的架構規範(如:MVC / MVVM、RESTful 命名規則)。由於 Codex 訓練資料涵蓋各種寫法,必須在 Prompt 中明確給定「邊界條件」。

  • 提示詞技巧:
    • 指定語法版本:「請使用 Java 17 語法與 Spring Boot 3 規範,勿使用過時的 API。」
    • 指定註解與架構:「請遵守 Lombok 註解規範(如 @RequiredArgsConstructor),並維持 Controller、Service、Repository 的職責分離。」

3. 採用「少樣本提示(Few-Shot Prompting)」傳遞專案風格

當你需要 Codex 撰寫符合特定格式的代碼(例如專案統一的 API 回傳格式 ApiResponse<T>),最快的方法是給它一個範例,而不是純文字描述。

💡 實戰 Prompt 範例:

「請參考以下專案現有的 Response 格式:

return ApiResponse.success(data);

請依照這個格式,幫我撰寫 UserController.java 中的 getUserById API 回傳值。」


4. 要求一步步思考並加上繁體中文註解(Chain of Thought)

複雜的商業邏輯(如算分機制、防呆驗證)很容易產生邏輯漏洞。請 Codex 在輸出代碼前先列出邏輯步驟,不僅能提高代碼正確率,也方便我們後續進行 Code Review。

💡 實戰 Prompt 範例:

「請幫我寫一個計算遊戲得分的邏輯。在給出程式碼前,請先用 1, 2, 3 點簡述你的解題步驟,並在生成的程式碼中加入詳細的繁體中文註解。」


掌握了這四大提示詞注意事項後,你就能徹底鎖定 Codex 的輸出品質,讓它精準地為你的專案服務,再也不怕 AI 亂改程式碼!


上一篇
Day 11 — Codex 實戰:從單端代碼生成企劃書到前後端完美統合
下一篇
Day 13 — Codex 開發實戰 (上):運用大模型快速建構核心邏輯與 UI 互動
系列文
人機協同程式開發實戰:用 AI 輔助開發 Swift 與 Spring Boot,打造屬於自己的程式 共 16 篇
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言