重構筆記//8 min
OpenSpec 重構老專案 Ep-1:init 與 profile 設定
用 spec-driven development 工具 OpenSpec 重構跑了兩年的老專案。這篇拆解 openspec init 跟 config profile 兩個入門指令，帶你搞懂 Delivery 與 Workflows 兩個維度怎麼決定你有哪些指令。跟著裝一次就上手。
#重構筆記#OpenSpec
← 首頁
重構筆記(6)
重構筆記//19 min
OpenSpec 重構老專案 Ep-2:裝好 PHP 與 Composer
動工 Laravel 前，先把 PHP 8 與 Composer 兩張入場券辦好。這篇用 Node.js 開發者秒懂的對照，帶你在 macOS / Linux / Windows 各自一行裝起來，還把 composer create-project 每個 token 拆給你看。照著裝完就能跑。
#重構筆記#OpenSpec#PHP#Laravel
重構筆記//23 min
OpenSpec 重構老專案 Ep-3:Next.js 16 前端開工
前端用 pnpm create next-app 開工。這篇拆解那行指令背後的 8 個 flag，完整解掉 ERR_PNPM_IGNORED_BUILDS（Ignored build scripts: sharp）的 approve-builds 陷阱、Node 版本怎麼對齊、首頁怎麼砍到 14 行驗證後端。
#重構筆記#OpenSpec#Next.js#React
重構筆記//12 min
OpenSpec 重構老專案 Ep-4:用 propose 設計 Sanctum 認證
認證功能開工。這篇用 /opsx:propose 走一次設計，帶你看 4 個 artifact 各在做什麼、Sanctum SPA 為什麼贏過 token 模式，還把最容易踩坑的「四觸點對齊」釘進 spec 級 requirement。純設計 walkthrough，看完就懂為什麼先寫 spec。
#重構筆記#OpenSpec#Laravel#Sanctum#Next.js
重構筆記//15 min
OpenSpec 重構老專案 Ep-5:交易核心與競態防線
碳匯交易核心一天從 propose 跑到 archive。挑 4 個設計決策講透：角色用 row 存在性推導、state machine 雙保險、同時購買競態用 DB transaction + lockForUpdate + UNIQUE 三層防線擋住。想學 Laravel 併發防護就看這篇。
#重構筆記#OpenSpec#Laravel#Next.js#State Machine
重構筆記//20 min
OpenSpec 重構老專案 Ep-6:揪出潛伏一年的 Sanctum bug
第四個角色 worker 接進來，卻踩到 phase-1 就埋下的潛伏 bug：server-side fetch 沒帶 Referer，Sanctum 不認 SPA session，SSR 認證鏈靜默斷掉。這篇完整記錄排查路徑，還講 saved listener 與 multipart 上傳的安全紅線。
#重構筆記#OpenSpec#Laravel#Next.js#Sanctum#Multipart