編碼代理的表單後端：讓 Claude Code 與 Cursor 真正收得到資料

Claude Code、Codex CLI 和 Cursor 的代理模式，前端代碼寫得漂亮，基礎設施卻一塌糊塗。讓它「加個聯絡表單」，它會生成一個好看的表單、接好 handleSubmit，然後攤手：POST 沒有去處。本地開發伺服器不是後端，而憑空捏一個 api.example.com 的代理，交付的只是一個死按鈕。

代理收不到資料，原因只有一個：它讀不到你本來要替它讀的文件。補上這一環，剩下的它自己都會做。這套「兩次交接」就是：機器可讀的接口文件，加一條它能在終端裡跑的命令列。

第一次交接：會自己寫文件的接口

在 FormLM 發布任意表單或測評，就得到一個分享接口。在地址後加 ?help，接口會把自身的 API 文件以 Markdown 返回——寫入格式、分頁查詢、匯總統計、限流規則、欄位自動建立，全在裡面：

curl "https://formlm.me/api/v3/share/YOUR_TOKEN?help"

把這個 URL 放進代理的上下文，幾秒它就學會了整個接口面。之後的規則都是代理熟悉的那套：向接口 POST {"data":{...},"meta":{...}} 結構的 JSON（也收平鋪物件），或讓原生 HTML 表單提交到 /form；從 /query 讀回記錄，從 /summary 拿匯總。載荷裡的新鍵會自動建成欄位，代理往頁面加一個輸入框，永遠不需要遷移步驟。

第二次交接：一條 npx 命令把測評建起來

收集只是半個活兒——另一半是讓每份提交值得收集的東西：計分邏輯、給每個作答者的報告、可發布的頁面。formlm-cli 是官方發佈在 npm 上的 MIT 命令列（Node.js ≥ 18），而編碼代理本來就握著終端，整個建構它都能自己驅動：

npx @formlm/cli smart generate "Digital marketing maturity diagnostic for agency prospects, 5 dimensions, scored PDF report"
npx @formlm/cli snapshot --summary
npx @formlm/cli share url

最有意思的是第一行：smart generate 把一句話需求變成一個完整的測評應用——題目、加權量表、條件邏輯、報告版面——並在服務端快取成執行計劃，代理可以逐模組執行。第二行把當前狀態匯出為 JSON，讓代理確切知道提交要對齊哪些欄位名。第三行返回分享令牌與頁面 URL：正是代理寫進 action= 或 fetch() 裡的那串地址。

一個真能跑通的提示詞

代理認約定不認意圖。下面這種寫法，收尾時是活的資料流，而不是攤手：

<p>Before wiring the form, run: npx @formlm/cli smart generate "<your brief"
Then read the API contract at https://formlm.me/api/v3/share/<token>?help
Build the page's submit against that contract: POST {data, meta},
show an inline success state, and add a company honeypot hidden with CSS.
Verify with a curl round-trip before you call it done.</p>

注意四個設計：代理是去建立測評，而不是假設已有一個；先讀約定，而不是猜欄位形狀；蜜罐必須點名——生成的頁面從不會自己加反垃圾設定；curl 往返則給了代理一條要跑綠的測試，和人類驗收跑的完全相同。

哪些仍歸你管

• 令牌是寫入地址，不是憑證。分享令牌只授權向一個表單提交，放進用戶端程式碼是安全的；Access Token（掌控整個帳戶、7 天過期）永遠不要進提示詞或程式碼庫。
• 垃圾提交照樣會來。接口側有全域限流；蜜罐欄位與讀取時過濾是生成頁面的功課——要明確要求它寫上。
• 計分留在平台，不留在代理裡。這正是重點：無論代理重生成多少版頁面，權重與報告邏輯始終穩定。