AI Coding 的真相:要寫出「大系統」,你得先當個稱職的文檔工程師

更新 發佈閱讀 3 分鐘
raw-image

AI Coding 被宣傳得天花亂墜,彷彿可以讓沒有程式基礎的人,輕鬆寫出可用的應用程式成品。

事實是:要寫出堪用且具備擴展性的程式碼,你還是得遵循傳統的工程紀律來運作。

別懷疑,AI 寫大系統的能力是可疑的

像我這樣,只有 Script 語言經驗、沒有接觸過 C++ 這類硬底子語言的人來說,想完全從頭用程式碼碼出一個大型應用系統,簡直是天方夜譚。

到目前為止,AI 在寫小程序方面表現出色,但要讓它獨立完成一個大型、複雜的應用系統,它的能力是可疑的。

因此,我的 AI 程式編寫策略是:化整為零。我將功能拆解成一個個小的應用程式,再要求它們具備相似的資料架構和 UI 規範,將其組合成相對完整的功能。

AI Coding 的秘密武器

要讓 AI 成功執行這個「化零為整」的任務,光靠幾句提示詞絕對不夠。這時,我們必須放下對 AI 神奇能力的幻想,回歸到最傳統的工程文件

我的做法是:在編寫程式碼之前,先製作並輸入以下四份文件,要求 AI 依照這些規格去規劃它的程式編寫。

raw-image

值得強調的是,這種「文件先行」的作法不單獨適用於某個 AI 編碼平台,所有平台都可使用,它是一種跨工具的工程紀律。

結論:AI Coding 的進化,來自於人為紀律

這樣做,結果是一點也不「vibing」了。沒有什麼神奇的魔法,只有扎實的文件和嚴格的規範。

但正是這種非情緒化、高度紀律化的運作方式,才能讓 AI 寫出來的程式碼不僅能跑,還能被管理、被維護、被組裝成更大的系統

AI 程式碼的上限,最終還是取決於你身為工程師所提供的紀律與架構。

<本文部分內容由 AI 協助生成,經人工編輯/發佈>

參考檔案: 真的只是參考用, 請依實際需求修改.

SRS.md Scenario.md Guideline.md README.md

SRS 編寫專家.v3 (協助使用者編寫SRS.md及Scenario.md的Gem, 提供讀者試用)

留言
avatar-img
沒什麼人味的訪談室
10會員
34內容數
分享跟AI間的問答, 特別是奇怪的問題
2025/10/15
第一部:補齊學習的「人腦端」盲區 許多人學新工具或新知識時,只專注於「軟體端」的操作,卻忽略了更關鍵的「人腦這一端」的方法。這就像你買了一輛跑車,卻只用一檔在開。 真正的學習,需要經過主動的準備,才能讓大腦進入吸收狀態。僅僅只是瀏覽過、看過、聽過,是絕對不夠的。認知自己正在學習,並積極參與「查證
Thumbnail
2025/10/15
第一部:補齊學習的「人腦端」盲區 許多人學新工具或新知識時,只專注於「軟體端」的操作,卻忽略了更關鍵的「人腦這一端」的方法。這就像你買了一輛跑車,卻只用一檔在開。 真正的學習,需要經過主動的準備,才能讓大腦進入吸收狀態。僅僅只是瀏覽過、看過、聽過,是絕對不夠的。認知自己正在學習,並積極參與「查證
Thumbnail
2025/10/06
你是否也曾對 AI 產出的內容感到不安?儘管 ChatGPT 和 Gemini 等 AI 助手在生成 Email 或文案時帶來極大便利,但我們不能忽略它潛在的風險。AI 生成的內容可能帶有不當或偏頗資訊,因此絕不可完全信任。 雖然所有主流 LLM 都內建了強大的「基礎防護」(用以防範騷擾、仇恨言論
Thumbnail
2025/10/06
你是否也曾對 AI 產出的內容感到不安?儘管 ChatGPT 和 Gemini 等 AI 助手在生成 Email 或文案時帶來極大便利,但我們不能忽略它潛在的風險。AI 生成的內容可能帶有不當或偏頗資訊,因此絕不可完全信任。 雖然所有主流 LLM 都內建了強大的「基礎防護」(用以防範騷擾、仇恨言論
Thumbnail
2025/09/28
拋開「垃圾進,垃圾出」的困境 在 AI 生成內容的時代,一個殘酷的法則依然存在:Garbage in, garbage out. 即使是全球最頂尖的 AI 模型,如果餵給它的是混亂、未經整理的資料,最終輸出的結果也難以令人滿意。 尤其是當我們從影片中取得逐字稿時,往往會面臨這個問題。直接用聲音轉
Thumbnail
2025/09/28
拋開「垃圾進,垃圾出」的困境 在 AI 生成內容的時代,一個殘酷的法則依然存在:Garbage in, garbage out. 即使是全球最頂尖的 AI 模型,如果餵給它的是混亂、未經整理的資料,最終輸出的結果也難以令人滿意。 尤其是當我們從影片中取得逐字稿時,往往會面臨這個問題。直接用聲音轉
Thumbnail
看更多
你可能也想看
Thumbnail
賽勒布倫尼科夫以流亡處境回望蘇聯電影導演帕拉贊諾夫的舞台作品,以十段寓言式殘篇,重新拼貼記憶、暴力與美學,並將審查、政治犯、戰爭陰影與「形式即政治」的劇場傳統推到台前。本文聚焦於《傳奇:帕拉贊諾夫的十段殘篇》的舞台美術、音樂與多重扮演策略,嘗試解析極權底下不可言說之事,將如何成為可被觀看的公共發聲。
Thumbnail
賽勒布倫尼科夫以流亡處境回望蘇聯電影導演帕拉贊諾夫的舞台作品,以十段寓言式殘篇,重新拼貼記憶、暴力與美學,並將審查、政治犯、戰爭陰影與「形式即政治」的劇場傳統推到台前。本文聚焦於《傳奇:帕拉贊諾夫的十段殘篇》的舞台美術、音樂與多重扮演策略,嘗試解析極權底下不可言說之事,將如何成為可被觀看的公共發聲。
Thumbnail
柏林劇團在 2026 北藝嚴選,再次帶來由布萊希特改編的經典劇目《三便士歌劇》(The Threepenny Opera),導演巴里・柯斯基以舞台結構與舞台調度,重新向「疏離」進行提問。本文將從觀眾慾望作為戲劇內核,藉由沉浸與疏離的辯證,解析此作如何再次照見觀眾自身的位置。
Thumbnail
柏林劇團在 2026 北藝嚴選,再次帶來由布萊希特改編的經典劇目《三便士歌劇》(The Threepenny Opera),導演巴里・柯斯基以舞台結構與舞台調度,重新向「疏離」進行提問。本文將從觀眾慾望作為戲劇內核,藉由沉浸與疏離的辯證,解析此作如何再次照見觀眾自身的位置。
Thumbnail
本文深入解析臺灣劇團「晃晃跨幅町」對易卜生經典劇作《海妲.蓋柏樂》的詮釋,從劇本歷史、聲響與舞臺設計,到演員的主體創作方法,探討此版本如何讓經典劇作在當代劇場語境下煥發新生,滿足現代觀眾的觀看慾望。
Thumbnail
本文深入解析臺灣劇團「晃晃跨幅町」對易卜生經典劇作《海妲.蓋柏樂》的詮釋,從劇本歷史、聲響與舞臺設計,到演員的主體創作方法,探討此版本如何讓經典劇作在當代劇場語境下煥發新生,滿足現代觀眾的觀看慾望。
Thumbnail
《轉轉生》為奈及利亞編舞家庫德斯.奧尼奎庫與 Q 舞團創作的當代舞蹈作品,融合舞蹈、音樂、時尚和視覺藝術,透過身體、服裝與群舞結構,回應殖民歷史、城市經驗與祖靈記憶的交錯。本文將從服裝設計、身體語彙與「輪迴」的「誕生—死亡—重生」結構出發,分析《轉轉生》如何以當代目光,形塑去殖民視角的奈及利亞歷史。
Thumbnail
《轉轉生》為奈及利亞編舞家庫德斯.奧尼奎庫與 Q 舞團創作的當代舞蹈作品,融合舞蹈、音樂、時尚和視覺藝術,透過身體、服裝與群舞結構,回應殖民歷史、城市經驗與祖靈記憶的交錯。本文將從服裝設計、身體語彙與「輪迴」的「誕生—死亡—重生」結構出發,分析《轉轉生》如何以當代目光,形塑去殖民視角的奈及利亞歷史。
Thumbnail
學習如何透過 .cursorrules 檔案有效「調教」你的 AI 程式碼輔助工具,提升程式碼品質、一致性和專案風格匹配度,從新手實習生升級為資深夥伴!
Thumbnail
學習如何透過 .cursorrules 檔案有效「調教」你的 AI 程式碼輔助工具,提升程式碼品質、一致性和專案風格匹配度,從新手實習生升級為資深夥伴!
Thumbnail
ChatGPT 推出強大程式碼生成工具 Codex,實現 Vibe Coding,只要用自然語言描述需求,就能產生程式碼。本文介紹 Codex 的三種使用方法:CLI 工具、VS Code 擴充套件和 GitHub 專案連結,並以實際案例示範如何用 Codex 建立 Linktree 頁面。
Thumbnail
ChatGPT 推出強大程式碼生成工具 Codex,實現 Vibe Coding,只要用自然語言描述需求,就能產生程式碼。本文介紹 Codex 的三種使用方法:CLI 工具、VS Code 擴充套件和 GitHub 專案連結,並以實際案例示範如何用 Codex 建立 Linktree 頁面。
Thumbnail
美國資深軟體工程師 Brian 研發出一套名為 BMAD 或 BMad-Method 的開發方法,解決單純依靠 AI 工具進行 Vibe Coding 所造成的混亂和資源浪費。透過明確 AI角色 分工,逐步產出詳細文件,再交由 AI 開發代理使用者故事逐步開發,確保產品品質與可維護性。
Thumbnail
美國資深軟體工程師 Brian 研發出一套名為 BMAD 或 BMad-Method 的開發方法,解決單純依靠 AI 工具進行 Vibe Coding 所造成的混亂和資源浪費。透過明確 AI角色 分工,逐步產出詳細文件,再交由 AI 開發代理使用者故事逐步開發,確保產品品質與可維護性。
Thumbnail
如果用AI取得成就或是賺到錢,算不算自己努力掙得的結果? 它跟以往我的工作模式不同,能夠大幅拉近我跟全端工程師那遙遠的差距到某一個程度。 如果站在公司的角度上來看我能做的事情一口氣大幅的變多也變快了,這是好事,也能大幅推進專案進度和刪減原本所需要的人力資源。 可是在我看來假如完整資歷全端開發經
Thumbnail
如果用AI取得成就或是賺到錢,算不算自己努力掙得的結果? 它跟以往我的工作模式不同,能夠大幅拉近我跟全端工程師那遙遠的差距到某一個程度。 如果站在公司的角度上來看我能做的事情一口氣大幅的變多也變快了,這是好事,也能大幅推進專案進度和刪減原本所需要的人力資源。 可是在我看來假如完整資歷全端開發經
Thumbnail
WebSim.AI 是一款創新的 AI 工具平臺,讓使用者只需輸入文字或網址,就能在瀏覽器中生成互動式網站、遊戲或虛擬空間。無需程式背景,即可快速建立產品示意頁、互動展示模擬,適合創意發想和原型設計。支援 Claude Sonnet 3.5、GPT-4 等模型。
Thumbnail
WebSim.AI 是一款創新的 AI 工具平臺,讓使用者只需輸入文字或網址,就能在瀏覽器中生成互動式網站、遊戲或虛擬空間。無需程式背景,即可快速建立產品示意頁、互動展示模擬,適合創意發想和原型設計。支援 Claude Sonnet 3.5、GPT-4 等模型。
Thumbnail
vibe coding的討論很火熱,我們可以使用瀏覽器的書籤功能,來練習以及製作我們自己的小工具唷。
Thumbnail
vibe coding的討論很火熱,我們可以使用瀏覽器的書籤功能,來練習以及製作我們自己的小工具唷。
Thumbnail
Vibe Coding 正在顛覆傳統程式開發模式,這種由 OpenAI 共同創辦人 Andrej Karpathy 在 2025 年提出的全新開發範式,讓開發者能夠用自然語言描述需求,由 AI 自動生成程式碼。這種「氛圍式程式設計」不僅降低了軟體開發門檻,更讓非專業的人也能透過 AI 開發應用程式。
Thumbnail
Vibe Coding 正在顛覆傳統程式開發模式,這種由 OpenAI 共同創辦人 Andrej Karpathy 在 2025 年提出的全新開發範式,讓開發者能夠用自然語言描述需求,由 AI 自動生成程式碼。這種「氛圍式程式設計」不僅降低了軟體開發門檻,更讓非專業的人也能透過 AI 開發應用程式。
Thumbnail
本文探討使用AI輔助程式開發的趨勢,以Vibe Coding為例,說明AI工具如何提高開發效率,並以Java程式碼範例展示如何使用AI產生讀取資料庫並輸出CSV檔案的程式碼,以及如何優化此程式碼。
Thumbnail
本文探討使用AI輔助程式開發的趨勢,以Vibe Coding為例,說明AI工具如何提高開發效率,並以Java程式碼範例展示如何使用AI產生讀取資料庫並輸出CSV檔案的程式碼,以及如何優化此程式碼。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News