MIXXIN Vibe Coder 入門課
APPENDIX · 第 9 堂三組方法的完整版

方法卡:三組看事情的方法

第 9 堂過了 27 張卡,正文只展開其中十一張。這一頁是完整版:每張卡一句白話、為什麼重要、你在前幾堂哪裡碰過、掛在需求/設計/實作的哪一步、進階去哪看。四週個案討論卡在哪就翻哪張;之後自己做東西,也拿它當檢查表。

附錄 · 非正課 系統思維 · 工程方法 · 產品方法 27 張卡 個案討論的檢查表
?
怎麼用這一頁
三組卡分別回答三個問題:東西怎麼組(系統思維)、怎麼做對(工程方法)、做的東西有沒有人要(產品方法)。不用背。你的題目卡在哪一步,去第 04 節找那一步掛的卡;跟工程師對話對不上時,找標「第 9 堂展開講」的那幾張,那些是公司內部實際在用的規則。
跟第 9 堂的關係:正文展開講的十一張這裡也有,內容一樣、多了「進階去哪看」。正文只列名字的那些,完整說明在這裡。公司系統的對照表在另一頁附錄:系統清單。
01系統思維:東西怎麼組8 張
S1邊界與承諾第 9 堂展開講

每一塊都有「裡面」和「外面」。你只需要知道它承諾什麼,不用知道它裡面怎麼做。

為什麼重要這是你不用變成工程師也能指揮系統的原因:Auth 承諾「告訴你這是誰」,你就不用管它怎麼驗密碼。描述需求時只講承諾,不講裡面,工程師跟 AI 都省事。
你其實碰過第 6 堂信任邊界:你自己出面授權,Notion 裡面怎麼記你不用管。第 7 堂掛 MCP:你沒讀過 Notion API 一行文件,照樣用。
掛在哪一步組成
進階去哪看arch.mixxin.tw 每個系統頁的「對外接口」欄,就是它的承諾清單。
S2真相只有一份第 9 堂展開講

同一份資料只能住一個地方。多複製一份,就多一個要同步的問題。

為什麼重要非工程師做工具最常見的第一步是「先抄一份到我的表」——三週後兩邊對不起來,沒人知道哪份是對的。判斷一個題目健不健康,先問:它的每一種資料,權威版本在哪。
你其實碰過第 4 堂「抄 vs 拉」:抄一份總數會過期,拉才是活的。第 5 堂全班看同一張 Notion 表,你貼的那列出現在同事畫面上。
掛在哪一步組成
進階去哪看專案追蹤列表就是示範:資料在 Notion,網頁只是把它畫出來。
S3主體的一生第 9 堂展開講

描述系統不是列功能,是講「一筆東西從出生到結束會經過哪些狀態」。

為什麼重要列功能會漏(「還要能取消嗎?取消後能復原嗎?」),講一生不會漏。工程師畫架構圖就是這樣畫的,你用同一種講法,對話直接對上。
你其實碰過揪團的一生:有人發起 → 有人跟 → 成團 → 結束。第 3 堂的 modal、第 6 堂的「誰跟了」,都是這一生裡的某一格。
掛在哪一步設計
進階去哪看公司架構圖的 flow 檔,選取軸就是「主體的一生」。
S4只記事實,狀態用算的第 9 堂展開講

「已審核」不是一個欄位,是「有一筆審核紀錄」推出來的。系統只記發生過的事,狀態是算出來的。

為什麼重要表單、簽核、退回、軌跡——只要你的題目有「狀態」,這是第一個會踩的坑:狀態欄跟紀錄對不上、退回後不知道退到哪。記事實就不會,因為事實不會互相矛盾。
你其實碰過第 6 堂那筆跟團紀錄有「誰」「什麼時候」,人數是算出來的,不是另外存一個數字。
掛在哪一步設計
進階去哪看公司後端守則的「事實解原則」:看到狀態/簽核/退回/audit 這些字,先讀那一節。
S5同一件事做兩次要一樣

重送表單不能多建一筆,通知重發不能寄兩封。

為什麼重要網路會斷、人會連按兩下、AI 會重跑。沒考慮這件事的工具,上線第一週就會出現重複資料,而且清不乾淨。
你其實碰過第 4 堂全班的「我要跟」按鈕:按第二次會不會又 +1?有處理的人當時其實就在做這件事。
掛在哪一步實作
進階去哪看工程師叫它「冪等」。你只要在需求裡寫一句「按兩次結果要跟按一次一樣」。
S6資料不會立刻到處一樣

快取有 60 秒、Notion 同步有延遲。「剛改怎麼還沒出現」多半不是壞掉,是還沒到。

為什麼重要看到「沒出現」就以為壞了、就叫 AI 重做,是最浪費的一種除錯。先問:這條路上有沒有快取、有沒有延遲。
你其實碰過專案追蹤列表本身就有 60 秒快取:你在 Notion 改完,最多等一分鐘。
掛在哪一步實作
S7接口是承諾,有人用就不能隨便改

欄位改個名,全班的頁面同時壞。

為什麼重要你自己的資料表想改就改;一旦有第二個人的畫面在讀它,欄位名就是承諾了。改之前要先問誰在用,或者加新欄位、舊的留著。
你其實碰過第 5 堂全班共用同一張餐廳列表:講師如果把「店名」改成「名稱」,14 個人的頁面同時空掉。
掛在哪一步設計
S8共用的代價是爆炸半徑

不重複造輪子的反面:共用件壞一次,全公司一起壞。

為什麼重要「要不要接公司現成的」不該是口號,是取捨:接了省事、也跟著它一起承擔風險;自己做一份不會被拖累、但要自己養。知道這個取捨,你的判斷才站得住。
你其實碰過教材站的登入是 Gate 那一行 script:Gate 掛掉,全站一起進不去。這是我們有意識選的。
掛在哪一步設計
02工程方法:怎麼做對12 張
E1走通一條線再加寬

先讓一筆資料從畫面走到儲存再回來,再加功能。

為什麼重要先把畫面做滿、再做資料、再做儲存,是最容易做到一半發現方向錯的順序。一條線走通,你就知道整條路有沒有坑。
你其實碰過整門課的揪團頁就是這樣長大的:第 1 堂一頁靜態、第 4 堂存得住、第 5 堂大家看同一份,每一步都是「加寬」。
掛在哪一步實作
E2先寫完成定義第 9 堂展開講

動手前先寫「怎樣算做完」。AI 說做完不算,要它拿證據。

為什麼重要沒有完成定義,AI 會自己決定做到哪,通常是「看起來像了」就停。有的話,你可以要它逐條證明:截圖、實跑結果、測試輸出。
你其實碰過每堂課開頭那個 Definition of Done 方塊,就是講師先幫你寫好的完成定義。
掛在哪一步需求
進階去哪看公司 AI 開發守則:「完成的定義」=改動已存檔+驗證證據在手+回報寫明怎麼驗的。
E3可逆與不可逆

能回頭的放手做,不能回頭的停下來問人。

為什麼重要這是「什麼時候該喚工程師」最實用的判準:改畫面、改自己的檔案,錯了可以回頭;刪正式資料、發訊息給全公司、改雲端設定,錯了回不來。
你其實碰過第 2 堂 git 可以回頭,所以敢放手讓 AI 改;第 6 堂寫進正式 Notion 那筆,寫了就在。
掛在哪一步實作
進階去哪看公司 AI 開發守則的破壞性操作清單,就是「不可逆」的具體名單。
E4不可逆的動作分兩段第 9 堂展開講

先預覽再確認。AI 或人都不准一步到位。

為什麼重要上一張卡說不可逆要停下來問人,這張卡是「怎麼問」:系統先算好、把結果攤給你看,你點確認才真的做。你自己做的工具如果有「送出」「發通知」「刪除」,照抄這個。
你其實碰過這堂第一次講。但你已經用過:公司 MCP 的報帳是先 prepare 給你看試算,你確認才 confirm 送簽。
掛在哪一步實作
進階去哪看公司 MCP 的 prepare/confirm 兩段式:報帳、請假都是這樣設計的。
E5做的人不能當驗的人第 9 堂展開講

AI 說做完了,要另一個沒看過過程的 AI 或人來驗。

為什麼重要做的人會替自己找理由,AI 也一樣——它讀自己改的東西一遍就說沒問題。開一個新對話、只給它完成定義,要它自己去跑去看,抓到的問題完全不同。
你其實碰過第 8 堂規劃模式攔到 AI「自己補上的事」,就是同一種懷疑。這堂把它變成固定動作。
掛在哪一步實作
進階去哪看公司 AI 開發守則第一條「驗證不自驗」:宣稱完成前,必須由另一個沒看過過程的 AI 或人來驗收。
E6嘗試有預算第 9 堂展開講

同一個問題修三次修不好就停,換方法或找人,不是再修第四次。

為什麼重要「再跟 AI 講一次就好」是無底洞:第四次通常跟第三次一樣,而且每次都在原地多繞一圈。三次是預算,用完就換路,這是紀律不是放棄。
你其實碰過第 4 堂作業 14 份裡有 10 份「讀 localStorage 有防護、寫沒有」,同一個坑很多人跟 AI 來回修了好幾輪。那時候如果第二次就換問法或找人,會早很多。
掛在哪一步實作
進階去哪看公司 AI 開發守則:3 次嘗試預算,第 2 次失敗就要升級或換路。
E7舊的不用一次換掉

新系統一條路徑一條路徑接手,舊的慢慢空掉。

為什麼重要你做的小工具多半是要取代某張試算表或 AppSheet。一次全換,換到一半兩邊都不能用;一次接一條,任何時候都能退回。
你其實碰過這堂第一次講。公司的 data-platform 正在用這招吃掉幾個舊系統。
掛在哪一步上線後
進階去哪看工程師叫它 strangler 遷移。你只要說「先接這一條,其他照舊」。
E8先寫上線那天要展示什麼

從 demo 倒推要做哪些,砍掉展示不到的。

為什麼重要比完成定義再往前一步,直接治「功能越做越多」:展示不到的功能,這一輪就不做。
你其實碰過每堂課的 WOW 那一行,就是那堂的 demo;整堂內容都是從它倒推的。
掛在哪一步需求
E9失敗要有人知道

每個接口都會壞。壞了誰收到訊息?

為什麼重要沒人知道的失敗比壞掉更糟:半年後才發現資料少了一段。每一個「跟外面要東西」的地方,都要想失敗時誰看得到。
你其實碰過第 4 堂全班 14 份裡 10 份「讀」的時候有防護、「寫」的時候沒有——寫失敗時畫面照常,沒人知道。
掛在哪一步實作
進階去哪看通知那一塊接 Notify Hub 的理由之一:失敗會留紀錄。
E10改一處要動幾處

一個改動要碰幾個地方,改的地方越多越危險(工程師管這叫耦合)。

為什麼重要收件人換了要改十個地方,是因為十個工具各自寫死。共用件(Notify Hub、Auth)存在的理由就是把「要改的地方」收成一個。你設計自己的東西時,問同一個問題。
你其實碰過第 3 堂把卡片改成讀資料檔:改一格資料、畫面自己長出來,改的地方從 N 個變 1 個。
掛在哪一步設計
E11決策留痕

為什麼這樣做,寫下來。PR 描述就是最小版本。

為什麼重要三個月後你自己也不記得為什麼選 Notion 不選試算表。留一句「因為要給同事一起改」,下一個人(或下一個 AI)就不會重新吵一次。
你其實碰過第 2 堂起每份作業的 PR 描述;第 8 堂的計畫書。
掛在哪一步上線後
E12上線不是結束

看使用的人怎麼用,下一輪改什麼。

為什麼重要第一版一定有猜錯的地方;上線是拿到真實回饋的開始,不是任務結束。四週個案討論就是這個迴圈的固定節奏。
你其實碰過第 3、4 堂課後講評:上線後講師逐頁看,下一堂帶回來改。
掛在哪一步上線後
03產品方法:做的東西有沒有人要7 張
P1使用者導向第 9 堂展開講

先找到一個真實的人,看他現在怎麼做、卡在哪,再想功能。

為什麼重要「大家應該會需要」是最貴的一句話。找一個真的人,看他現在的做法,痛點會自己跑出來,而且比你想像的十個功能都具體。
你其實碰過第 8 堂規劃模式問的「給誰用、現在怎麼做、做完差在哪」,就是它。
掛在哪一步需求
P2MVP第 9 堂展開講

不是功能少的版本,是「能證明值得做」的最小版本。做出來先給人用。

為什麼重要很多人把 MVP 理解成「先做個陽春版」,然後陽春版永遠沒人用。MVP 的重點是驗證:做到剛好能讓那個真實的人用一次、告訴你值不值得繼續。
你其實碰過第 1 堂那頁靜態揪團頁就是 MVP:不能跟團、不會存、沒有登入,但已經能拿給同事看、問他會不會用。
掛在哪一步需求
P3視覺優先第 9 堂展開講

先讓 AI 生一頁假的畫面給使用者看,比寫需求文件快十倍,改也便宜。

為什麼重要非工程師最大的優勢就在這:你不用會寫,AI 半小時能生一頁看得到的東西。拿它去問使用者「是這樣嗎」,得到的回答比看文件準得多。
你其實碰過整門課都是先看到畫面再談資料:第 1 堂先生 HTML,第 4 堂才存資料。
掛在哪一步設計
P4從流程不從畫面

使用者要完成一件事會經過哪幾步,每一步一個畫面。

為什麼重要從畫面開始想,會做出一堆漂亮但接不起來的頁;從流程開始,畫面數量自然浮現,而且不會漏掉「確認」「出錯」這種沒人想畫的頁。這張卡跟「主體的一生」是同一件事的兩面:一個看人,一個看資料。
你其實碰過揪團:看到 → 想跟 → 按下 → 確認 → 成團。第 3 堂的 modal 是「想跟」那一步的畫面。
掛在哪一步設計
P5可用性三問

看得懂嗎、找得到嗎、做錯了能回頭嗎。加三個常被忘的畫面:空的、載入中、出錯了。

為什麼重要AI 生出來的畫面預設只有「一切正常」那一種狀態。第一次沒資料時是空白、載入時是空白、出錯時還是空白,使用者只會覺得壞了。這三個畫面要你主動要。
你其實碰過第 4 堂的錯誤訊息;專案追蹤列表的「尚未填入」就是空狀態。
掛在哪一步實作
P6減法

每個功能都是維護負擔。砍比加難。

為什麼重要加功能只要一句話,養功能要一輩子。系統地圖裡那 61 個業務系統,不少已經沒人維護——每一個當初都是「加一下應該沒差」。
你其實碰過第 9 堂的系統地圖盤點結果。
掛在哪一步上線後
P7回饋迴圈

做、給人用、看、改。週期越短越好。

為什麼重要一個月做完再給人看,錯了要重做一個月;一週一次,錯了改一週。四週個案討論就是把這個週期固定下來。
你其實碰過第 3、4 堂的課後講評 → 下一堂改。
掛在哪一步上線後
04按三步查你卡在哪一步,就翻那一步的卡
需求先寫完成定義、先寫上線那天要展示什麼、使用者導向、MVP
設計主體的一生、只記事實,狀態用算的、接口是承諾,有人用就不能隨便改、共用的代價是爆炸半徑、改一處要動幾處、視覺優先、從流程不從畫面
實作同一件事做兩次要一樣、資料不會立刻到處一樣、走通一條線再加寬、可逆與不可逆、不可逆的動作分兩段、做的人不能當驗的人、嘗試有預算、失敗要有人知道、可用性三問
上線後舊的不用一次換掉、決策留痕、上線不是結束、減法、回饋迴圈
組成邊界與承諾、真相只有一份