00 / AGENTIC ENGINEERING
Agentic 工程
這一頁記錄我怎麼把 AI 寫進開發流程。起點和多數人一樣,是 vibe coding——用一句話描述需求,收下看起來能動的程式碼。這種做法在丟棄式腳本上成立,但放到有真實使用者的系統就會失效:產出不可重現、錯誤藏在沒人讀過的程式碼裡,而且沒有任何東西擋在 AI 與生產環境之間。
現在的做法是把 agent 當成需要被工程化管理的協作者:規格先行、上下文受控,每一次產出都要通過驗證迴圈與人工審核才算數。下面是這套方法的拆解,以及它實際運作的兩個場域——本網站,和兩個在高科大生產環境運行的系統。
01 / FROM VIBE TO AGENTIC
從 vibe 到 agentic
差別不在用不用 AI,而在流程有沒有工程性質:可驗證、可重現、有人負責。
VIBE CODING
AGENTIC
SPEC
VIBE一句話需求,規格邊生成邊想。
AGENTIC先寫規格與驗收條件,agent 對著規格工作,偏離就退回。
CONTEXT
VIBE每次對話從零開始,重複解釋專案。
AGENTICAGENTS.md 與跨 session 記憶:專案慣例、硬性禁令與歷史決策都在 agent 的上下文裡。
VERIFY
VIBE「看起來能跑」就採用。
AGENTIC測試、E2E、無障礙與效能門檻構成迴圈;不過關就退回 agent 重做,而不是由我手動收尾。
REVIEW
VIBE產出直接進 codebase。
AGENTIC人工審核是必經關卡:每個階段通過審核,才進下一階段。
REPRODUCE
VIBE結果是一次性的,換個專案就重來。
AGENTIC規格與流程本身是文件,同一套方法可以在下一個系統重跑。
02 / THE LOOP
03 / EVIDENCE / THIS SITE
本網站:流程本身就是產物
這個網站以十階段流程開發——研究、資訊架構、線框、視覺、動效、SEO、前端架構、開發、驗證、驗收——每階段先產出文件,經人工審核通過才進入下一階段。案例內容也不是手寫的行銷稿:先訂取材規格,派 agent 進四個專案 repo 逐一核實,再依核實結果改寫,數字以 repo 為準。整個過程留在公開的 git 歷史裡,可以逐條驗證。
- docs/phase-1…7
- 每一階段的規格與審核文件——流程本身留有紀錄。
- docs/content-request.md
- 內容取材規格:agent 進各專案 repo 核實事實後,case study 才據以改寫。
- AGENTS.md · memory
- agent 帶著專案慣例、硬性禁令與跨 session 的決策紀錄工作。
- commit 7fd3e21
- 驗證迴圈實例:對比度檢測出 3.13:1,修至 WCAG AA(≥ 4.5:1)。
- commit bf3fa85
- 效能門檻實例:案例截圖轉 WebP,1.5 MB → 218 KB(−86%)。
- github.com/NameCallBob
- 原始碼與完整 commit 歷史公開可查。
04 / EVIDENCE / PRODUCTION
校園系統:有守門,agent 才碰生產
兩個系統——高科大系友會平台與設備借用系統——有真實使用者,所以 agent 的每一次修改都先過守門:借用系統的 repo 內有自己的 AGENTS.md,1,112 個後端測試與 RWD 驗證器擋在合併之前。系友會平台的資安修補則以六階段稽核管線進行:系統理解、前後端 findings、修補 backlog、「已驗證修復」與「待驗證」分流,最後才落地。UIUX 也用同一套方法在兩個系統各跑一輪:頁面盤點、Top 30 問題、上線阻斷項、修復清單。
- SECURITY_REVIEW
- 六份文件的稽核管線:SEC-001–030 修補,權限模型翻轉為 default-deny。
- UIUX_AUDIT × 2
- 兩個系統各一輪:頁面盤點 → Top 30 → 上線阻斷 → 修復清單。
- AGENTS.md(borrow)
- repo 內建的 agent 工作規範:結構、測試指令、命名與提交慣例。
- 1,112 tests · RWD
- agent 產出的守門:後端整合測試,加上 Puppeteer RWD 驗證。
- aaic.nkust.edu.tw
- 兩系統上線中:系友會平台,與 equipment-borrowing.binbinbob.work。
05 / BOUNDARIES
界線
哪些事不交給 agent——這一節和前面的流程一樣重要。
- 01
架構與資料模型的決策不外包:agent 提供選項與分析,取捨由我決定並記錄下來。
- 02
個資與公司內部資料不進 agent 的上下文;要公開的內容一律先做保密邊界處理。
- 03
產出不等於完成:通過測試、E2E 與人工審核才算數;資安修補必經人工確認才上線。