【學習筆記】AI 亂寫 Code?你把需求說清楚了嗎?

更新 發佈閱讀 6 分鐘

最近在社群平台上看到好多人發文,內容大概就是我使用 xxx 模型,輕鬆開發出了一個可以用的程式,甚至有很多不是工程師本業的人都做到了。我想說真的那麼神嗎?結果我已經花了兩週的時間還是沒辦法開發出我覺得正常的系統。這讓我思考問題到底出在哪?

在我深入研究這個問題的根源時,我接觸到了 《規格驅動全自動開發術》 這套課程。這才讓我意識到問題的核心:

會寫程式的工程師不等於能開發出能解決問題的系統。

真正的問題在於,我們缺乏一個能讓 AI 精準執行的藍圖。其實,開發系統就如課程提到的翻譯鏈,工程師應該要學會把「業務抽象」到「技術指令」完整做完整的翻譯,才有可能讓 AI 開發出我們想像中的系統。目前軟體開發上的難題一樣是在溝通上,如果能把翻譯做好,其實最後實作的部分不論是靠人類或 AI 都能做好!只是 AI 的優勢是他能更快速且品質有一定水準的實作。

接下來,我會整理學習這套課程翻譯方法的心得,重點解析這條「翻譯鏈」的三個關鍵站點

第一站:串起業務領與與工程領域的共同語言 — Event Storming

產品經理與工程師經常在對立面,產品經理關心業務價值,而工程師關注程式寫不寫得好。系統是否可用且好用,關鍵在與這兩者是否有完整的溝通。

如果要讓不同領域的人可以良好溝通,就需要共同的語言,而 Event Storming (事件風暴) 就是這個橋樑。Event Storming 不僅是團隊討論工具,它更是**系統邊界的建模**。他讓大家明確知道當下最重要需要解決的問題到哪裡,系統需要做的什麼程度。

透過 業務事件 (Event) 狀態的改變可以推出因果鏈

Actor觀察 Read Model -> 下達Command -> 透過 Rules 檢查-> 改變 Aggregate 狀態-> 產生 Event

這套流程圖完美地貫穿了 Problem 和 Solution 兩個領域。它讓工程師知道「要做什麼」(業務需求),也讓業務知道「系統如何運作」(系統流程)。

第二站:從共同語言轉化為業務規格 — DSL-Level Gherkin

我們最終目標是要寫出程式碼,所以 PM 與工程師有共識後,需要把這些結果轉換成可執行的規格。在這個級別,先不討論技術上的細節,而是列出系統上的案例 (Example)情境 (Scenario)。目的是讓關心業務相關的人員可以看得懂的層次,在本課程中這個級別的語言稱為DSL (Domain Specific Language) Gherkin

根據 Event Storming 的結果,我們可以歸納出兩種翻譯模式,並確保它們都遵循 **「Spec by Example」(透過具體範例定義規格)的原則:


vocus|新世代的創作平台


以實際案例來說

Feature: 食譜管理

  Rule: 建立食譜時應包含基本資訊

    Example: 成功建立食譜需包含必要資訊
      Given 使用者輸入食譜名稱「番茄炒蛋」
      And 使用者輸入預計烹飪時間「15」分鐘
      And 使用者加入主要食材「雞蛋」與「番茄」
      When 使用者儲存食譜
      Then 食譜「番茄炒蛋」應成功建立

第三站: ISA-Level Gherkin(測試程式碼的組合語言)

我們使用 AI 幫忙開發系統時,最怕的就是 AI 腦補。

可以透過定義測試框住 AI 開發的範圍,但剛剛的 DSL 並沒有包含到以下兩點

  • 技術場域:這是前端、後端還是移動端,已經呼叫的方式(API、UI...)
  • 技術參數:API 的路徑在哪?請求的 Body 結構是什麼?

ISA (Instruction Set Architecture) 級別的 Gherkin 是介於 DSL (高階語言) 和實際測試程式碼 (機器碼) 之間的「組合語言」。它是一個測試程式碼的抽象層

  • ISA 的定義:它使用 Gherkin 語法,但其步驟 (Step) 明確指定了技術操作技術參數
  • ISA 的作用:它消除 AI 的所有腦補空間,讓 AI 只需要「翻譯」指令,而不需要「思考」測試邏輯。

Feature: 食譜管理

  Rule: 建立食譜時應包含基本資訊

    Example: 成功建立食譜需包含必要資訊
Given 使用者輸入食譜名稱「番茄炒蛋],烹飪時間「15」分鐘,加入主要食材「雞蛋」與「番茄」, with table:
| name | cooking_time | ingredients |
| 番茄炒蛋 | 15 | 雞蛋, 番茄 |
When (UID="$Ming.id") 儲存食譜
Then 回應 200
And 驗證存在新增的食譜, with table:
| name | cooking_time | ingredients |
| 番茄炒蛋 | 15 | 雞蛋, 番茄 |

個人反思:從過程導向到結果導向

這就是 AI 時代軟體工程師的職涯轉型:不再是單純實現「怎麼跑」(過程導向),而是要定義「結果要什麼」(結果導向)。

向上,必須更精準的對準業務需求;向下,必須將規格消除與 AI 協作時的模糊性。


------

立即和我一樣到水球軟體學院學習「AI x BDD:規格驅動全自動化開發術」課程,就抽 Claude Code Pro 版一年份!

這裡行動:https://waterballs.tw/y0vtd

趕快將活動分享出去,越多人參加,中獎人數越多!

詳細活動規則請見官網。





留言
avatar-img
樹杷林柳橙誌
1會員
6內容數
記錄生活、思考、心得
你可能也想看
Thumbnail
本文探討 AI 及 Vibe Coding 作為學習程式設計輔助工具的潛力,並分享如何在自學與提升個人編程能力上,有效利用這些工具,克服資訊過載、缺乏指引、動力不足等阻礙,模擬協作開發、程式碼審查,甚至自動化任務,最終達成「活用工具,創造差異化價值」。
Thumbnail
本文探討 AI 及 Vibe Coding 作為學習程式設計輔助工具的潛力,並分享如何在自學與提升個人編程能力上,有效利用這些工具,克服資訊過載、缺乏指引、動力不足等阻礙,模擬協作開發、程式碼審查,甚至自動化任務,最終達成「活用工具,創造差異化價值」。
Thumbnail
本文分析導演巴里・柯斯基(Barrie Kosky)如何運用極簡的舞臺配置,將布萊希特(Bertolt Brecht)的「疏離效果」轉化為視覺奇觀與黑色幽默,探討《三便士歌劇》在當代劇場中的新詮釋,並藉由舞臺、燈光、服裝、音樂等多方面,分析該作如何在保留批判核心的同時,觸及觀眾的觀看位置與人性幽微。
Thumbnail
本文分析導演巴里・柯斯基(Barrie Kosky)如何運用極簡的舞臺配置,將布萊希特(Bertolt Brecht)的「疏離效果」轉化為視覺奇觀與黑色幽默,探討《三便士歌劇》在當代劇場中的新詮釋,並藉由舞臺、燈光、服裝、音樂等多方面,分析該作如何在保留批判核心的同時,觸及觀眾的觀看位置與人性幽微。
Thumbnail
這是一場修復文化與重建精神的儀式,觀眾不需要完全看懂《遊林驚夢:巧遇Hagay》,但你能感受心與土地團聚的渴望,也不急著在此處釐清或定義什麼,但你的在場感受,就是一條線索,關於如何找著自己的路徑、自己的聲音。
Thumbnail
這是一場修復文化與重建精神的儀式,觀眾不需要完全看懂《遊林驚夢:巧遇Hagay》,但你能感受心與土地團聚的渴望,也不急著在此處釐清或定義什麼,但你的在場感受,就是一條線索,關於如何找著自己的路徑、自己的聲音。
Thumbnail
【開發日誌 #3:告別黑視窗,GUI 介面初登場!】 核心進展: Qt 6 GUI 介面:視覺化操作,告別指令輸入。 整合 SQLite:實現手牌數據的永久本地儲存。 即時儀表板:一鍵導入,立即查看 VPIP/PFR 關鍵數據。
Thumbnail
【開發日誌 #3:告別黑視窗,GUI 介面初登場!】 核心進展: Qt 6 GUI 介面:視覺化操作,告別指令輸入。 整合 SQLite:實現手牌數據的永久本地儲存。 即時儀表板:一鍵導入,立即查看 VPIP/PFR 關鍵數據。
Thumbnail
5 月將於臺北表演藝術中心映演的「2026 北藝嚴選」《海妲・蓋柏樂》,由臺灣劇團「晃晃跨幅町」製作,本文將以從舞台符號、聲音與表演調度切入,討論海妲・蓋柏樂在父權社會結構下的困境,並結合榮格心理學與馮.法蘭茲對「阿尼姆斯」與「永恆少年」原型的分析,理解女人何以走向精神性的操控、毀滅與死亡。
Thumbnail
5 月將於臺北表演藝術中心映演的「2026 北藝嚴選」《海妲・蓋柏樂》,由臺灣劇團「晃晃跨幅町」製作,本文將以從舞台符號、聲音與表演調度切入,討論海妲・蓋柏樂在父權社會結構下的困境,並結合榮格心理學與馮.法蘭茲對「阿尼姆斯」與「永恆少年」原型的分析,理解女人何以走向精神性的操控、毀滅與死亡。
Thumbnail
SSD的演進與複雜性:從HDD到NAND Flash的革命 固態硬碟(SSD)的出現,標誌著儲存技術的一次重大飛躍。相較於傳統的機械硬碟(HDD),SSD以其無與倫比的速度、抗震性、靜音操作和更低的功耗,迅速佔領了市場。這一切的改變,都源於其核心儲存介質——NAND Flash。NAND Flas
Thumbnail
SSD的演進與複雜性:從HDD到NAND Flash的革命 固態硬碟(SSD)的出現,標誌著儲存技術的一次重大飛躍。相較於傳統的機械硬碟(HDD),SSD以其無與倫比的速度、抗震性、靜音操作和更低的功耗,迅速佔領了市場。這一切的改變,都源於其核心儲存介質——NAND Flash。NAND Flas
Thumbnail
背景:從冷門配角到市場主線,算力與電力被重新定價   小P從2008進入股市,每一個時期的投資亮點都不同,記得2009蘋果手機剛上市,當時蘋果只要在媒體上提到哪一間供應鏈,隔天股價就有驚人的表現,當時光學鏡頭非常熱門,因為手機第一次搭上鏡頭可以拍照,也造就傳統相機廠的殞落,如今手機已經全面普及,題
Thumbnail
背景:從冷門配角到市場主線,算力與電力被重新定價   小P從2008進入股市,每一個時期的投資亮點都不同,記得2009蘋果手機剛上市,當時蘋果只要在媒體上提到哪一間供應鏈,隔天股價就有驚人的表現,當時光學鏡頭非常熱門,因為手機第一次搭上鏡頭可以拍照,也造就傳統相機廠的殞落,如今手機已經全面普及,題
Thumbnail
這篇文章分享了作者從轉職到前端工程師的經驗,並說明在AI時代學習程式的三大理由:AI降低了寫程式的門檻、學習程式能開啟更多職涯機會,以及享受自行打造程式的樂趣。作者也分享了自己的學習資源,例如ccClub Python共學社團、Udemy的Python課程和六角前端線上課程,並鼓勵大家學程式。
Thumbnail
這篇文章分享了作者從轉職到前端工程師的經驗,並說明在AI時代學習程式的三大理由:AI降低了寫程式的門檻、學習程式能開啟更多職涯機會,以及享受自行打造程式的樂趣。作者也分享了自己的學習資源,例如ccClub Python共學社團、Udemy的Python課程和六角前端線上課程,並鼓勵大家學程式。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News