Cloud-F1 · Alex Hsieh · 領域金字塔 Layer 4

AI Coding · 領域飛輪

ai-coding-template ── 一套我自己長出來的軟體模板。詳見 aicoding-alex.md

2026 / 05 / 08
Layer 4 案例書 v1.0
Domain Flywheel
同時跑在模板上的專案 · LIVE PROJECTS
7

第一個案子的雛型 長到 7 個專案共享同一架構。 每接一個新案子,我做的不只是這個案子,是讓 ai-coding-template 又進化一次。 第一個 ~6 週,第二個 ~3 週,現在新案子壓在 1-2 週。

7
PROJECTS
同一套 React + FastAPI + Postgres + JWT
3
對外營運
yu-shan / shiftflow / clock-work
8
SUBAGENTS
orchestrator · strategist · spec-writer · designer · dba · reviewer · debugger · deployer
~80%
CLAUDE 寫
我寫 PRD,Claude 寫 code
0
工程師背景
SRE / DevOps,不是傳統 SWE
6 → 1
飛輪複利
第 1 個 → 第 7 個案子上線時間
第一次看 · 閱讀地圖

這份文件刻意先看「跑了什麼」、再拆「怎麼長出來」

§I 7 個專案 看我實際在跑什麼 → §II 截圖證據 看真的有上線 → §III 模板組成 知道底下怎麼搭 → §IV 飛輪機制 看上一個案子怎麼幫下一個 → §V 起手三步 換你怎麼起跑 → §VI 風險矩陣 我踩過的坑 → §VII 對應 case-畠山 同一架構不同領域。

不是工程師? §III 模板組成裡的 Postgres / agent / Skills 等技術名詞,先跳過沒關係 ── 看 §I §II §IV §V 就夠你開始想自己的飛輪。

I · 飛輪上的專案

Projects On
The Flywheel

7 專案
3 對外 + 3 工具 + 1 模板
01
昱山商務中心 · yu-shan.com ↗
模板第一個對外案例 ── 商務中心官網
對外營運⑨ 業務日誌
LIVEPUBLIC
02
dev-shiftflow · 賭場排班
54 + 43 人輪班、覆蓋率追蹤、請假簽核 → dev-shiftflow.zeabur.app ↗
對外營運④ 會計搬家
LIVESAAS
03
dev-clock-work · CHRONOS 打卡
GPS 打卡、自動算薪、勞基法合規 → dev-clock-work.zeabur.app ↗
對外營運⑨ 業務日誌
LIVESAAS
04
案例 #5 · 活動管理
報名、簽到、出席統計 ── 個人/小團體用
個人工具
DEVTOOL
05
案例 #6 · 金融管理
記帳、分析、結算 ── 自己用的私有工具
個人工具
DEVTOOL
06
案例 #7 · 場地預約
球場排程、人員湊團、線上付款
個人工具
DEVTOOL
07
dev-coding-template · 模板自身
每次新案子的起點 ── 模板回灌的目的地 → dev-coding-template.zeabur.app ↗
COREMETA
COREMETA
II · 截圖證據

Evidence
From Production

5 張截圖
flywheel 真的存在的證據
III · 模板組成

Template
Composition

8 模組
per ai-coding-template
給非工程師的白話翻譯

記住一句就好:底下這 8 個東西,7 個案子都共用,所以新案子才能 1-2 週上線。 每次接新案子,我不需要重做登入、API、資料庫、部署、AI 編排這 5 件事 ── 它們已經在模板裡。 我只需要寫「這個案子業務上跟別的案子有什麼不一樣」。
來源:ai-coding-template/docs/techstack/architecture.md

01
Frontend · React 18 + Vite + TypeScript
Zustand(auth state)+ React Query(server state)+ axios + tokenCache;所有對外網站 + dashboard 共用同一套 UI
UICROSS-PROJECT
7USES
02
Backend · FastAPI 0.115 + Python 3.12
Pydantic v2 模型 + REST/JSON + OpenAPI 契約;所有案子共用同一套 API 結構
APIFASTAPI
7USES
03
Auth · PyJWT + bcrypt + slowapi 限流
JWT 驗證快取(30s TTL)+ middleware:CORS;登入/註冊/權杖更新跨案子不重做
BUILTINSECURITY
7USES
04
Database · PostgreSQL 15 + Alembic + SQLAlchemy 2.x async
UUID v4 PKs + DB triggers;migration(資料表升級)慣例跨案子共用
DB
7USES
05
Deployment · Zeabur(一鍵部署)
7 個專案在同一個 Zeabur dashboard ── 部署/運維(DevOps)成本下降 60%
DEPLOYPLATFORM
1BUTTON
06
Agent 編排層 · 8 個 Claude Code subagent
orchestrator(總協調)/ strategist(規劃)/ spec-writer(PRD)/ designer / dba / reviewer / debugger / deployer / qa / evaluator … 跨案子重複使用,經驗自動累積
AGENTSREUSED
8ROLES
07
記憶層 · 2-tier memory
Tier 0 ~/.claude/template-memory/(跨案子智慧)+ Tier 1 docs/context/(本案狀態)── 業務規則、命名、踩過的雷,新案子第一天就有
TIER 0TIER 1
SESSIONS
08
規格層 · openapi.yaml + docs/specs/
每案 PRD 寫在 docs/specs/,API 契約寫在 openapi.yaml ── 我寫需求,Claude 寫 code、寫 review、寫 deploy
HUMAN-ENTRY
7SPECS
IV · 飛輪機制

How The
Wheel Turns

4 個機制
讓上一個案子幫下一個
01

模板複用 — DevOps 成本下降 60%

第一個案子最痛的不是寫業務邏輯,是搞定環境。把 auth(JWT/bcrypt)、API(FastAPI)、deploy(Zeabur)、CI、Postgres migration 抽到 template,新案子第一天就有可運作的骨架。這層是飛輪能轉的前提。

機制起點 · aicoding-alex.md §4.1
02

8 Subagent 編排 — 經驗自動累積

orchestrator / strategist / spec-writer / designer / dba / reviewer / debugger / deployer ── 同一組 subagent 跨案子用,它們會「記得」上次怎麼做。每個案子產生的 pattern 自動回寫到 template。不是 agent 多強,是同一組 agent 跨案子用。

經驗載體 · aicoding-alex.md §4.2
03

CLAUDE.md + Skills — 領域知識跨案子保留

每個案子有自己的 CLAUDE.md,但跨案子共通的(Postgres 命名、auth 流程、Zeabur 部署慣例)抽到模板。我接第 7 個案子時,Claude 已經知道我所有的命名慣例、客戶禁用詞、設計鐵律。零上下文遺失。

記憶機制 · aicoding-alex.md §4.3
04

PRD 是我的入口,程式碼是 Claude 的責任

以前:客戶說需求 → 我 google → 我寫 code → 客戶驗收。
現在:客戶說需求 → 我寫 PRD → Claude 寫 code → 我審 + 客戶驗收。
PRD 時間沒變,寫 code 時間從 80% 砍到 ~20% ── 剩下時間拿去接更多案子或讓模板長更大。

工作流翻轉 · aicoding-alex.md §4.4
V · 起手三步

Recommendations

短期 3 / 中期 3 / 長期 2
共 8 項

Step 1盤點

1-2 WEEKS
S1
盤點重複案子的共通元素
列出過去 3 個案子裡每次都做的事(auth / deploy / 通知 / 報表)
FROM aicoding-alex.md §6.1
P0
S2
第一個案子做到「能複製」
CLAUDE.md 寫到位、PRD 模板化、Skills 拆出來
8-12 hr
P0
S3
第二個案子強迫複用
不允許從零開始,只允許 fork 第一個並補差異
3-5 hr
P1

Step 2編排

1-3 MONTHS
M1
Agent 編排成形(7 角色)
plan / implement / review / debug / doc / deploy / test 固化
跨案子經驗才會累積
P1
M2
CLAUDE.md 抽出共通層
命名、流程、Voice 進模板;業務規則留案子層
才會有真正的累積
P1
M3
每個新案子強迫回灌模板
fork-only-no-merge 是反模式,要設規則
不回灌就沒飛輪
P0

Step 3收成

3-6 MONTHS
L1
模板產品化
變成 SaaS / 課程 / template marketplace 商品
已經養出來了,不商品化是浪費
P1
L2
接案類別變狹窄
只接模板能吃的案子,不能吃的轉介出去
Focus 才能讓飛輪轉更快
P1
VI · 風險矩陣

Risk Register

9 項風險
likelihood × impact
R0
Layer 4 假象 ── 看似飛輪其實只是「我做事比較快」(Layer 3 標準化錯認 Layer 4)
LH
用「下個案子比上個快多少」量化檢查;不快就不是飛輪
R1
模板過度抽象 ── 抽太多變數反而讓新案子變慢
HM
抽象只在「3 次以上重複」之後做;不要預測未來
R2
Claude 寫的程式碼維護成本 ── 一年後誰看得懂、誰來修
MM
每個 PR 強制 commit message + ADR;不允許黑盒
R3
Zeabur 平台鎖定 ── 7 個專案全綁同一家,平台漲價或關閉影響全線
HL
模板保留 Docker compose 一鍵搬家;每季演練一次
R4
8 subagent 互相依賴 ── 一個 agent prompt 改壞,整條 pipeline 斷
ML
agent 改動有版本號;改完跑 dry-run 測試
R5
領域知識不夠深 ── 模板很強但客戶不買單(Layer 1 不足)
HM
接案前先做 Layer 1 訪談;Layer 1 不通就不接
R6
單點失效 ── 模板只我一個人能修,生病飛輪停
MH
模板文件化到「外人 1 週能上手」;ADR 寫透
R7
接太多案子忽略飛輪本身 ── 飛輪該長的時候在做案子,飛輪變停。本月必辦
HH
每月固定 20% 工時投在模板本身;不接超量案子
R8
過度依賴 Claude ── Claude 出包/降版/限流時整條斷
MM
模板兼容 Sonnet/Opus 雙版本;關鍵流程有人類 fallback
VII · 對應 case-畠山

Same Architecture,
Different Domain

他與我的差別
只在領域
畠山做的事
我做的事
共通機制
60 家客戶記帳 SOP 沉澱進 Skills
7 個專案沉澱進 ai-coding-template
工作經驗反向長系統
每接一個新客戶 Skills 又長一點
每接一個新案子模板又長一點
案子 → 模板的單向回流
發票轉換腳本被 Claude Code 寫
案子 ~80% 程式碼被 Claude Code 寫
程式碼是 Claude 的責任,不是我的
業務日誌可視化讓客戶看到價值
7 個專案 dashboard 讓客戶看到價值
資料可視化是飛輪的證據

Claude Code 是工具,領域知識才是燃料 ── 這正是 Layer 4 飛輪的核心命題。