Figma Specs：把 Markdown 文件搬上畫布，讓團隊和 AI 共用同一份規格

出處：Figma〈Introducing Specs: Markdown as a medium〉，Figma Blog，2026-10-15。閱讀原文

原文作者：Luke Zhang（FigJam 與 Specs 產品經理）、Johnny Dallas（Specs 技術負責人）、Aosheng（Specs 產品設計負責人）。

本文為中文導讀，依原文段落順序改寫，非官方翻譯；圖片出自原文，版權屬 Figma。原文另有 4 段示範影片，網頁載入時才播放，未收錄。

開頭：Specs 是什麼

Figma 推出 Specs：一個放在 Figma 畫布上、用來裝「脈絡」的文件容器。把任何 .md 檔拖進畫布，就會變成一份 Spec。

為什麼要做這個？現在越來越多人跟 AI agent 合作，Markdown 已經變成大家交代背景資料的標準格式。但 Markdown 檔有幾個問題：

• 通常躺在自己電腦裡，只有一個人在改

• 檔案跟檔案之間的關係很脆弱

• 跟當初產生它的專案幾乎沒有連結

大部分脈絡用完就丟，但有一部分會變成需要長期修改、多人一起改的重要資料。Specs 就是給這種資料一個多人協作的家，而且可以在 Figma 裡外自由進出。

團隊和 agent 可以把文字寫的意圖、視覺探索、技術細節放進同一份計畫，從原型一路帶到上線。（原文這裡有兩段影片：agent 直接在 Spec 裡回覆留言；把 PRD 拖進畫布，請 agent 用 FigJam 腦力激盪的點子擴寫。）

同一波更新還有：

• MCP 錯誤更少、用的 token 更少

• agent 可以生圖、建 code layer、跑 Weave 流程

• 新增 20 個串接，把 Figma 的脈絡帶進更多工具

怎麼開一份 Spec：在 Figma 或 FigJam 按鍵盤 D，或點工具列的 Specs 圖示。

跟團隊和 agent 共用脈絡

Figma 工程師 Noah Finer 做 Specs 這個功能時，自己就是用 Spec 給寫程式的 agent 當參考：

• 先寫一份 Spec，列出處理邊界情況的原則，嵌進 FigJam 的流程圖

• 分享給同事留言

• 定稿後，把 Spec 連同同事的留言，透過 Figma MCP 交給寫程式的 agent

• 寫程式的過程中，用 MCP 回頭更新畫布上的 Spec；也讓 agent 在 FigJam 畫新的圖、嵌進 Spec，再傳給負責 code review 的同事

串接（connector）也能把外部資料帶進 Spec：

• 寫技術規格時，用 GitHub 串接直接從程式碼抓資料

• PRD 裡有個問題需要數據回答，就選取那個問題、加上 Hex 串接，請 agent 跑分析，結果會以留言的形式出現在問題旁邊

也可以把畫布上的東西拖進 Spec（例如和團隊一起發想的設計、使用者流程圖），之後再拖出來，Figma 的屬性還會保留。（原文這裡有一段影片示範拖進拖出。）

在畫布上的不同素材之間移動

Spec 就放在它描述的設計旁邊。可以拖入現成的 Markdown，也可以請 Figma agent 在設計和程式旁邊直接起草。Spec 還能複製，讓每個人先各自改自己的版本，再一起決定方向。

Intuit 的資深產品設計師 Mark Harvey 在做一組新圖示時，把 Spec 放在圖示旁邊，每一筆記下圖示的檔名、分類、搜尋標籤和說明，團隊在同一個地方就能看完圖示和細節。他說，格式一致的文件讓非設計師也更容易看懂設計檔。

把方向定下來

脈絡一多，就很難整理出下一步。工程師在畫面上的註記、code layer 裡新的設計系統做法、設計評審的回饋，都可以整理成一份放在旁邊的可編輯文件，大家拉遠一看就能同時看到結論和所有相關脈絡。

Figma 研究員 Mike Blight 的做法：大家先用便利貼、留言、註記討論各種方向，最後他把決定和還沒解決的問題整理進一份 Spec。下一次探索時，就從這份 Spec 接著做。他把這叫做「一起探索 → 收斂成果 → 繼續推進」的循環。

Figma agent 也能參與：它讀得到也寫得了 Spec 裡的留言，可以請它對每一則未解決的留言提出修改建議，同時同事也在同一份文件上討論。每段對話各自一串，可以同時進行好幾串。

Figma 工程師 Kat Busch 要把成果分享出去時，會整理成一份 Spec，agent 可以當成 Markdown 讀。如果功能改名了，直接請 agent 去改 Spec 就好。

交給程式上線

透過 Figma MCP，像 Codex 這樣的 agent 可以讀 Spec，也看得到它連結的所有脈絡。

團隊定好方向後，複製 Spec 的連結貼進寫程式 agent 的 prompt 就行。Markdown 內文、引用的 frame、流程圖、code layer、Code Connect 片段都會一起帶過去。

從第一個點子到最後上線，Specs 讓團隊和 agent 在同一個地方擬計畫，也拿得到執行計畫需要的脈絡。不管是寫 PRD 的 PM、記錄設計決策的設計師，還是規劃架構的工程師都用得上。

上線狀態：網頁版、桌面版、手機版都有，今天起以公開測試版開放給付費方案。

詞彙對照