7天｜AI Agent開發RaceOne超馬管理系統

從零到上線實戰記錄｜Hermes Agent + Supabase + Next.js

7天開發 ~12K LOC 12 Tables 28 Routes 34 RLS Policies $0 API成本
專案總覽超馬賽事全生命週期管理平台
RaceOne Hermes Agent Supabase Next.js Vercel $0成本
報名
Wizard
簽到
掃碼
計時
分段
補給
追蹤
DNF
管理
報表
Notion

單兵作戰・2週MVP・跑者旅程數位化・主辦方零負擔

R-01 C-01
技術棧最小可行性組合
Agent框架Hermes Agent
核心模型Nemotron-3-Ultra (free)
本地備選DeepSeek-Coder-V2
後端/DBSupabase (PostgreSQL+RLS)
前端框架Next.js 14 + TS + Tailwind
UI元件shadcn/ui
部署-AdminVercel (Hobby免費)
部署-GatewayHetzner VPS ($5/月)
Bot平台LINE + Telegram
本地優先 多租戶RLS 零設定部署 免費額度全覆蓋
R-02 C-01
7天時間軸每日關鍵交付
Day 1-2
啟動與基礎設施：SOUL.MD憲章、Supabase RLS架構、Vercel CI/CD、raceone.ai域名
Day 3-4
核心域模型：賽事/組別/報名/自訂欄位 CRUD、動態表單引擎(9類型)、條件顯示、驗證
Day 5
公開報名流程：多步驟Wizard(基本資料→緊急聯絡人/醫療→確認→付款)、NeWebPay串接
Day 6
賽日操作：簽到掃碼/搜尋、即時計時分段排名、補給站物資追蹤、DNF/DNS醫療轉送
Day 7
進階穩定化：財務儀表板、Notion雙向同步、GitHub Issue↔任務、關鍵Bug修復
R-03 C-01
AI Agent優勢從寫Code到做決策
①架構決策模式
人20%指令 + AI 80%代碼 + 人 10%審查
②持久記憶
SOUL.MD憲章 + 跨Session脈絡 + 決策歷史
③自我改進
每輪提煉→更新技能→修正憲章 v1.0→v1.3
④多平台同步
單指令改SQL+前端+Env+技能
⑤接力開發
Cron每小時：盤點Git→挑步驟→修碼→Build→Push
R-04 C-01
避坑指南血淚換來的5大關鍵坑點
坑點
錯誤現象
根本原因
修復方案
核心教訓
RLS無限遞迴
42P17錯誤
Policy內查同表
SECURITY DEFINER函數繞過RLS
Policy絕不直接查同表
認知偏差
追NextAuth 2hr
以為用NextAuth
實際用@supabase/ssr
先讀原始碼再下結論
表單失效
按鈕無反應
onSubmit包裝層斷裂
直接綁定+type=submit
Form三要素缺一不可
環境變數
Build過部署失敗
Vercel Env未同步
部署前清單驗證
Build vs Runtime區分
Cron模式
只能看Log不能修
用腳本模式
改Agent模式+完整Prompt
監控用腳本、推進用Agent
R-05 C-01
交付數據7天可量化成果
12K
程式碼行數
12
資料表
28
API路由
34
RLS策略
4
遷移檔案
$0
API成本
部署：Vercel + Hetzner VPS + Supabase Cloud
測試：1 Super Admin + 3 測試跑者
Hermes Skills：6個專用技能
R-06 C-01
實踐心法給開發者的5條建議與核心感悟
1
先寫憲章再寫代碼
SOUL.MD是不偏航的錨點
2
重複工作封裝成Skill
一次配置、無限複用
3
善用記憶與Cron接力
睡覺時系統也在進化
4
人在迴路審關鍵決策
AI產出、人把關、共同簽名
5
接受不完美快速迭代
快速驗證、誠實回報、即時修正
核心感悟

從「寫Code的人」變成「設計跑者旅程的人」。技術是手段，初心是跑者。

RaceOne.ai GitHub Repo Hermes Agent
R-07 C-01