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

更新 發佈閱讀 3 分鐘

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
留言分享你的想法!
avatar-img
沒什麼人味的訪談室
1會員
16內容數
分享跟AI間的問答, 特別是奇怪的問題
2025/10/15
第一部:補齊學習的「人腦端」盲區 許多人學新工具或新知識時,只專注於「軟體端」的操作,卻忽略了更關鍵的「人腦這一端」的方法。這就像你買了一輛跑車,卻只用一檔在開。 真正的學習,需要經過主動的準備,才能讓大腦進入吸收狀態。僅僅只是瀏覽過、看過、聽過,是絕對不夠的。認知自己正在學習,並積極參與「查證
2025/10/15
第一部:補齊學習的「人腦端」盲區 許多人學新工具或新知識時,只專注於「軟體端」的操作,卻忽略了更關鍵的「人腦這一端」的方法。這就像你買了一輛跑車,卻只用一檔在開。 真正的學習,需要經過主動的準備,才能讓大腦進入吸收狀態。僅僅只是瀏覽過、看過、聽過,是絕對不夠的。認知自己正在學習,並積極參與「查證
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 模型,如果餵給它的是混亂、未經整理的資料,最終輸出的結果也難以令人滿意。 尤其是當我們從影片中取得逐字稿時,往往會面臨這個問題。直接用聲音轉
2025/09/28
拋開「垃圾進,垃圾出」的困境 在 AI 生成內容的時代,一個殘酷的法則依然存在:Garbage in, garbage out. 即使是全球最頂尖的 AI 模型,如果餵給它的是混亂、未經整理的資料,最終輸出的結果也難以令人滿意。 尤其是當我們從影片中取得逐字稿時,往往會面臨這個問題。直接用聲音轉
看更多
你可能也想看
Thumbnail
去歐洲真的是又興奮又緊張。網路上常說歐洲治安不好,行前說明會時領隊也提醒:「不要背後背包,隨身物要放在前面比較安全!」 但出國玩總是想打扮得美美的啊~而且隨身總得帶些實用小物:雨傘、濕紙巾、小瓶水、萬用藥膏……體積雖小,但零零總總裝起來也不少。我在蝦皮購買了這4樣超實用旅遊好物!減緩我的焦慮感。
Thumbnail
去歐洲真的是又興奮又緊張。網路上常說歐洲治安不好,行前說明會時領隊也提醒:「不要背後背包,隨身物要放在前面比較安全!」 但出國玩總是想打扮得美美的啊~而且隨身總得帶些實用小物:雨傘、濕紙巾、小瓶水、萬用藥膏……體積雖小,但零零總總裝起來也不少。我在蝦皮購買了這4樣超實用旅遊好物!減緩我的焦慮感。
Thumbnail
開箱 3 套深受 0-6 歲寶寶喜愛的互動式童書,包含 Bizzy Bear 推拉書、小小音樂大師有聲書、Poke A Dot 泡泡書,有效提升寶寶閱讀興趣與親子共讀時光。搭配蝦皮雙 11 購物攻略,教你如何鎖定免運、折價券、高額回饋,並透過蝦皮分潤計畫,將日常購物開銷轉化為穩定育兒基金,聰明消費。
Thumbnail
開箱 3 套深受 0-6 歲寶寶喜愛的互動式童書,包含 Bizzy Bear 推拉書、小小音樂大師有聲書、Poke A Dot 泡泡書,有效提升寶寶閱讀興趣與親子共讀時光。搭配蝦皮雙 11 購物攻略,教你如何鎖定免運、折價券、高額回饋,並透過蝦皮分潤計畫,將日常購物開銷轉化為穩定育兒基金,聰明消費。
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檔案的程式碼,以及如何優化此程式碼。
Thumbnail
最近學到一個新的名詞Vibe Coding。 一開始我還以為是新的AI 寫程式的方式。 新聞上偶而也會穿插出這個名詞,有個小女孩用Vibe Coding做出什麼東西,然後為之世人驚豔。 昨天想說我也要來用用看,看有多好用。 便上網GOOGLE查詢一下,才知道這是現下流行的Coding方式
Thumbnail
最近學到一個新的名詞Vibe Coding。 一開始我還以為是新的AI 寫程式的方式。 新聞上偶而也會穿插出這個名詞,有個小女孩用Vibe Coding做出什麼東西,然後為之世人驚豔。 昨天想說我也要來用用看,看有多好用。 便上網GOOGLE查詢一下,才知道這是現下流行的Coding方式
Thumbnail
利用 Google Apps Script 串接 LINE 聊天機器人和 OpenAI,打造每日定時傳送鼓勵訊息、提供對話的自動化系統。文章分享開發過程中的心得和遇到的問題,如 LINE Messaging API 如何僅針對特定群組回訊、App Script 除錯、及 OpenAI費用考量。
Thumbnail
利用 Google Apps Script 串接 LINE 聊天機器人和 OpenAI,打造每日定時傳送鼓勵訊息、提供對話的自動化系統。文章分享開發過程中的心得和遇到的問題,如 LINE Messaging API 如何僅針對特定群組回訊、App Script 除錯、及 OpenAI費用考量。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News