背單字網頁重做(二):有經驗的人怎麼拆解,拆成 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。
一個規劃、一個實作加驗證、一個獨立審查。產出 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
整個專案的驗收只有八題,寫在藍圖最上面。每一題都能用眼睛或一條指令回答,沒有一題是「好不好用」這種要靠感覺的問題:
- 一毛錢都沒付網址公開可用?
- 不登入八歲小孩 30 秒內開始第一題?
- 上傳一份 CSV就多了一套題目?
- 舊網站匯出的歷程 JSON 匯進來錯字統計一致?
- 儀表板一眼看得懂今天練了幾個字、連續幾天、最不熟的五個字?
- 每個畫面按鈕不超過五個?
- 對比 AA全部通過?
- 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 看過才會公開。
還沒有公開的留言。