我們去參加鐵人賽了——30 天,把一張 AAA 標章的誕生過程全部攤開
我們報名了 2026 iThome 鐵人賽,Modern Web 組,連載 30 天。
題目是一件我們真的做完的事:一個不寫 Python 的前端,用 AI 蓋出一把網頁無障礙檢測 CLI,拿自家官網當白老鼠,送數位發展部審查,拿到 MODA 無障礙 AAA 標章。從第一個 commit 到標章核發,中間 26 天——工具不是先蓋好才送審的,是送件當天 repo 才剛開,被退件三次一路逼出來的。
這篇是連載目錄。每天在 iThome 發一篇,這裡就同步補一格——順便寫上那篇到底在講什麼,讓你不用點進去才知道值不值得讀。
這 30 天在講什麼
兩條線交錯著走。
- AI 線:一個不會寫某種語言的人,怎麼靠 AI 把構想推到 PyPI、推到政府認證。包含哪些地方 AI 幫得上、哪些地方它把人坑得很慘。
- 無障礙線:Tab 鍵走不走得到那顆按鈕、焦點跑到哪裡看不看得見、手機上的 icon 按鈕手指按不按得中、螢幕縮到 320px 版面會不會爆。這些掛在「無障礙」名下,但同時就是使用者體驗的地基。
中間兩週各自純化,頭尾則交織在一起。工具本身(a11y-moda)是 MIT 授權、原始碼公開,上了 PyPI,也內建 Claude Code、Cursor、Copilot、Aider 與通用 agent 五種整合模板,一行指令就能接進你現在用的 AI 助手。任何人都可以裝起來,自己驗證我們講的每一句話。這個設計背後的取捨,我們寫過一篇:為什麼我們把無障礙工具同時上 PyPI 和包成 AI Skill。
還有一件事先說在前面:這個系列由 AI 協作撰寫,第一篇開頭就攤開了協作方式與把關流程。我們公司的業務本質就是教企業怎麼這樣用 AI,所以這 30 天本身就是一份 case study。
連載目錄
下面依發布順序排。連結會直接開 iThome 的原文。
開場先給結果:一行指令跑完自家 8 頁 AAA 全站掃描。重點是那句「C 是選擇題,E 是申論題」——AAA 自評 20 題全部都是 E 碼,這就是整個系列要解的問題。
- Day 02我們的工具說「全綠」,人工審查回來 9 條
送件前自己掃 0 fail,12 天後審查意見回了 9 條。其中 7 條的規則檔早就躺在專案裡、跑過、還給了綠燈——拆解自動化檢測的四種典型盲區。
每天更新一篇,這份目錄會跟著長出來。也可以直接追 iThome 上的系列目錄。
接下來會走到哪
四週的骨架已經定了,逐日的題目會隨著寫作進度往上補。
- W1Day 1—7為什麼要蓋這把刀
- 痛點、規範長什麼樣、現有工具的邊界在哪。
- W2Day 8—14AI agent 怎麼生規則
- 技術核心:prompt 工程、AI 友善的架構設計、LLM 與 VLM 怎麼判斷,還有安全防線。
- W3Day 15—21網頁無障礙的真功夫
- AI 比例下降,Playwright 上場。每天拆一個前端常見的誤解。
- W4Day 22—28真的有用嗎
- 拿真實網站跑、AI 協作的翻車實錄、接進 CI、標章送審到核發的完整紀錄。
- 收尾Day 29—30還缺什麼
- 剩下的缺口、社群召集、整個系列的完整復盤。
跟很多 30 天系列不一樣的地方:每一篇都有可以複製貼上執行的程式碼,跟可以驗證的結果。白老鼠是我們自家網站——包括第一天就掃出來的兩個 fail 在內,修壞的部分全部公開。
為什麼把目錄放在自己網站
因為 iThome 是別人的地。
賽事期間流量會集中在那邊,這是好事。但 30 天結束之後,這個系列是不是還找得到、還排不排得上搜尋、能不能被我們自己的客戶讀到,那要看它有沒有一份長在自家網站上的入口。
內容放在平台上是租的,放在自己的網域才是資產。這是我們對客戶講了很多次的話,自己當然也得照做。
你可以怎麼用這 30 天
看你是誰,路線不一樣。
- 正在被無障礙審查退件的人:直接跳 Day 2。那篇講的是我們送件前自己掃 0 fail、12 天後審查回了 9 條意見,以及那 9 條為什麼工具沒抓到。官方工具抓不到的那一塊,我們之前也寫過:Freego 全綠也可能退件。
- 想知道 AI 到底能幫到哪的老闆:W2 那週是核心。重點不是「AI 好厲害」,是選對機制比選對模型重要——20 題自評裡,11 題用最樸素的 DOM 解析就夠了,丟給 LLM 是浪費錢又不穩定。
- 前端工程師:W3 每天拆一個常見誤解,Playwright 上場,全部有程式碼。
- 想看真實數據的人:W4 是實測週,包含 AI 協作的翻車實錄跟標章送審到核發的完整紀錄。我們也自爆過一次:把自己的無障礙報告攤給你看。
工具是副產品,方法才是產品
合理的疑問:顧問公司不是應該去接案嗎,做工具幹嘛?
因為工具能被外部驗證,形容詞不行。講一百次「我們懂無障礙」,不如把程式碼開源出來讓人看,再加上一張官方核發的標章。
而真正在賣的東西也不是那把工具——是「一間不寫 Python 的公司,怎麼用 AI 把一個構想推到能被政府驗收」這套流程。這個流程可以搬到你公司的任何領域。
如果你公司正在被無障礙審查卡住,或者想知道現有的工具流程接不接得上 AI——寫信給我們,先問問題不收費。想看服務怎麼收費,方案頁都寫在上面了。










