工作流拆解

背單字網頁重做(二):有經驗的人怎麼拆解,拆成 AI 聽得懂的檔案

「需求講清楚之後呢?從一句話到一個做得出來的網站,中間到底要拆成什麼?」夥伴的提問

拆解的產出是檔案,不是程式碼。逆向工程、重新設計、交給三個 agent,每一階段抽一段實際產出給你看。三個原則:檔案交接、驗收題全是 YES/NO、防「造假通過」的三道鎖。

上一份教材把一句話心願展開成七條邊界。這一份看接下來的事:有經驗的人怎麼把七條邊界,拆成一疊 AI 聽得懂、人也看得懂的檔案。

先說結論

01拆解的產出是檔案,不是程式碼

很多人以為「拆解」是工程師在紙上畫流程圖,然後開始寫程式。這個案例裡不是。拆解的結果是一個資料夾,裡面全是 Markdown 檔,每一份都能用一般的文字軟體打開來讀。

第一階段:逆向工程

看現況、逐條裁決、寫出學習旅程。產出 spec/01-current.md、spec/02-journey.md、spec/03-csv-format.md。

第二階段:重新設計

線框、品牌、資料模型。產出 design/wireframes.md、design/brand.md、design/data-model.md。

第三階段:交給三個 agent

一個規劃、一個實作加驗證、一個獨立審查。產出 plan/、tests/、reports/。

每一階段的輸出,都是下一階段的輸入。中間沒有「口頭交代」這一步。

第一階段

逆向工程:先看現況,再逐條裁決

逆向工程不是抄。是把「現在有什麼」列成表,然後每一列問一次:留、簡化、拿掉、還是要新增?

實際產出片段:spec/01 功能表

02每一列一個裁決,一句理由

AI 先用瀏覽器把夥伴的網站實際走了一遍,數了每個畫面的按鈕(首頁上半有 16 顆),列出全部功能,再依七條邊界逐條裁決。完整的表有三十幾列,這裡抽四列:

區塊舊功能裁決理由
字卡3D 翻轉字卡;點空白處看答案並發音保留核心互動,小孩也懂
練弱點特訓(門檻至少答錯 N 次)簡化改由間隔複習排程自動決定今天要練誰,拿掉手動滑桿
歷程Firebase 雲端同步、Global 存查歷史紀錄拿掉要錢、要金鑰、要後端;免費靜態版沒有這一層
新增連續天數(streak)新增6 到 18 歲最有效的黏著機制

「保留、簡化、拿掉、新增」四個詞就是全部的判準。不需要懂程式也看得出這張表在說什麼,而且每一列都可以反對:覺得「弱點特訓」不該簡化,就在那一列說。

實際產出片段:spec/02 學習旅程

03打開之後,孩子會經歷什麼、我們要記下什麼

CYC 口述時有一句話,決定了這份文件的形狀:

「這些 log 行為跟選擇複雜的系統架構跟簡單的系統架構是沒有關聯的,關鍵在於你有沒有清晰的掌握到,在學習的旅途中哪些是關鍵必須被記錄的 log。」

CYC 原話,2026-09-23

所以 spec/02 對三個年齡帶各寫了一條六步的旅程,每一步都有一欄「這一步記錄的事件」。抽 6 到 8 歲那條的三步:

步驟孩子看到什麼孩子做什麼這一步記錄的事件
1 打開之後每次:動物嚮導+「嗨,{暱稱}」+一顆大「開始」。自己按「開始」。session_start
3 練一畫面一題。喇叭大鍵自動唸一次,下面 3 個英文字大按鈕。按喇叭可重聽;按其中一個字。review(每題一筆,含反應時間)
4 看到回饋答對:按鈕變綠、大勾、嚮導跳一下,1.2 秒後自動下一題。答錯:正確答案亮綠,出現一顆「知道了」。答錯時按「知道了」再往下。連對五題不另記,由 review 序列算出

必記的事件只有幾樣:哪個字、哪種題型、對或錯、反應時間、時間戳、下次複習時間。儀表板要顯示的三個數字(今天練了幾個字、連續幾天、最不熟的五個字)全部從這幾樣算出來。

先想清楚要記什麼,架構簡單還是複雜就不重要了。

第二階段

重新設計:線框、品牌、資料模型

規格說「要什麼」,設計說「長什麼樣、放在哪」。三份檔案,每一份都還是文字。

實際產出片段:design/ 三份檔案

04線框用表格畫,品牌用理由寫,資料用「住在哪裡」交代

線框:一共 19 個畫面,每個畫面一列,最重要的欄位是「可點元素數」。這一欄直接對應邊界「每畫面三到五顆按鈕」,也直接給第三階段的審查者拿去數。抽三列:

代號名稱進入方式可點元素數(最多的狀態)
S1首頁:首次設定/延續網址根目錄首次 4、延續 6–8 歲 2、延續 9–12 歲 5、13–18 歲不停留
S4讀:看字選義出題程式自動進入4(6–8 歲)/5
S9小結(每 10 題)第 10 題作答後自動進入2/3/4

品牌:邊界說「有品牌,動物或色彩主題」。設計檔選了台灣犬,取名「小步」,理由寫成四條,每一條都能反駁:

牠真的會走在前面幾步,然後回頭看你

狗散步時的自然動作,剛好就是「嚮導比你多走幾步、願意帶你」的畫面。梅花鹿會跑掉,貓頭鷹跟 Duolingo 撞。

台灣孩子熟悉

校園、路口都看得到;豎耳、鐮刀尾,一眼認得出來。

不分年齡

6 歲覺得可愛,16 歲不會覺得是幼兒卡通。造型走幾何簡約。

畫得出來

頭是圓、耳是三角、鼻是小圓,三種形狀就成立。

資料模型:回答上一份教材的那個問題「資料庫要放哪」。答案是一張「儲存總覽」表,寫清楚每一樣東西住在哪、多大、為什麼。抽兩列:

儲存區內容大小估計(一年)為什麼放這裡
localStorage voc.last上次是誰、上次練哪套< 1 KB第二次打開要在 5 秒內到第一題;首頁不必等資料庫開好
IndexedDB reviews每答一題一筆,只增不改約 33 MB(一台裝置三個孩子、每天 100 題、連續一年)儀表板全部從這裡現算;欄位記全,日後換演算法不必重收

三個孩子練一整年,全部紀錄約 55 MB,一台手機的瀏覽器裝得下。這就是「不需要資料庫」的數字版。

第三階段

交給三個 agent:規劃、實作驗證、獨立審查

到這裡才開始「做」。但做的人不是一個 AI,是三個,各拿不同的輸入。

實際產出片段:plan/ 工作包

05三個 agent 各拿什麼、交什麼

Agent輸入輸出驗收
A 規劃spec/、design/、研究筆記工程計畫:每條規格標「必須/應該/可有可無」,切成一包一包可以獨立驗收的工作包每個工作包都有一題 YES/NO
B 實作+驗證A 的計畫、A 交付的測試成品+每一輪的報告(測試指令與原始輸出、截圖、人工檢查表、爭議)全綠至少兩輪
C 獨立審查只給成品網址與規格,不給 A、B 的過程審查報告:以創作者、家長、學生三個身分,各自不靠引導完成任務三個身分各完成任務 80% 以上

Agent A 交出來的計畫把整件事切成 12 個工作包,順序固定。抽兩包看它長什麼樣:

工作包要做的事(節錄)驗收題
WP-01 靜態骨架+首頁 30 秒進題建全部 19 個畫面的空殼、貼入品牌色、三份預設題庫、首頁四種狀態、按年齡帶直接進第一題「第一次打開」的八個自動測試案例全綠?
WP-09 舊歷程匯入讀舊網站匯出的 JSON、逐人對應暱稱、對不到的題庫先暫存、匯入後第一輪先練錯過的字錯字總次數 27 → 27、再匯一次不變、最不熟五字一致、前 10 題至少 7 題是匯入字?

每一包的驗收題都是一句能用 YES/NO 回答的話。「做得差不多」不是答案。

原則一

06先講清楚再動手:用檔案交接,不用對話交接

三個 agent 之間不對話。A 讀的是 spec/ 和 design/,B 讀的是 A 寫下的 plan/,C 讀的只有成品和規格。每一站都從檔案開始,也在檔案結束。

對話交接

「你剛剛說的那個功能,記得要做。」對方記得多少,你不知道;換一個視窗,全部歸零。

檔案交接

「照 plan/engineering-plan.md 的 WP-03 做。」誰來接都一樣;三個月後再開也一樣。

這也是為什麼前兩個階段花的力氣比第三階段多。講清楚的成本付在前面,後面就不用一直回頭補。

原則二

07驗收題全部是 YES/NO

整個專案的驗收只有八題,寫在藍圖最上面。每一題都能用眼睛或一條指令回答,沒有一題是「好不好用」這種要靠感覺的問題:

  1. 一毛錢都沒付網址公開可用?
  2. 不登入八歲小孩 30 秒內開始第一題?
  3. 上傳一份 CSV就多了一套題目?
  4. 舊網站匯出的歷程 JSON 匯進來錯字統計一致?
  5. 儀表板一眼看得懂今天練了幾個字、連續幾天、最不熟的五個字?
  6. 每個畫面按鈕不超過五個?
  7. 對比 AA全部通過?
  8. Agent C 的三個身分各完成任務 80% 以上?

八題往下長成 Agent A 的兩百多條規格,每一條也都配一個測試名或一個人工檢查方法。從最上面到最下面,都是同一種句型:這件事,YES 還是 NO?

問不出 YES/NO 的需求,AI 沒辦法自己驗收,你也沒辦法。

原則三

08AI 最大的風險不是寫錯,是「造假通過」

研究筆記裡有一個數字:在某個測試裡,AI 寫的程式在它看得到的測試上通過 97%,在它看不到的測試上通過 0%。意思是它學會了「讓測試變綠」,不是「把事情做對」。所以這個案例加了三道鎖:

測試鎖住

驗收測試由 A 交付,B 不准改一個字。交付時比對檔案指紋,不一致就算沒交。B 覺得測試寫錯,只能寫進報告的「爭議」段,由人裁決。

留一組看不到的

B 交付之後,另外跑一組 B 從來沒看過的隱藏測試:不同數值、不同題庫、不同年齡帶。紅了直接退回。

審查者另開視窗

C 是新的視窗,只拿到成品網址和規格,不知道 A 怎麼規劃、B 怎麼做。它看到的就是使用者看到的。

三道鎖沒有一道需要懂程式。它們是規則,不是技術:誰能改什麼、誰看得到什麼、誰在什麼時候進場。

動手練習

09為你的題目寫三個 YES/NO 驗收題

拿上一份教材填好的那一句心願,往下寫三題。每一題都要能用眼睛看、或用一個動作試出來。

夥伴的題目(範例)你的題目
第一題清掉瀏覽器資料後打開網址,不看說明,30 秒內按到第一題?
第二題上傳一份 30 個字的 CSV,題庫清單裡多了一套、可以開始練?
第三題關掉分頁再打開,今天練過的字數還在?

寫完自問

  • 這一題有沒有「好」「順」「方便」這類字?有就換成看得見的動作或數字。
  • 一個沒參與過的人,照著題目做一次,會不會得到和你一樣的答案?
  • 三題裡有沒有一題是「失敗了會很明顯」的?沒有的話,加一題。

三題寫得出來,你就有資格把題目交出去了。

下一份

交給 AI 執行,然後看報告

拆解到這裡,人的工作暫時告一段落。下一份教材看三個 agent 真的跑起來會產出什麼:兩輪測試的原始輸出、每個畫面的截圖、以及一個沒參與過程的審查者用三種身分試用之後寫的報告。你不用看程式碼,也看得懂它哪裡過了、哪裡沒過。

回到最開頭那一句:AI 代替手,不代替腦。這一份教材裡的每一張表,都是腦的產出;下一份才輪到手。

留言

CYC 看過才會公開。

還沒有公開的留言。

看其他教材

留言