3-2 透過 Cursor 協助寫出更好的設計文件

在這個單元中，我們將探討如何透過 Cursor 撰寫更好的技術設計文件。

首先，業界目前越來越有一個趨勢，是團隊選擇將技術設計文件直接存放在程式碼庫中。例如，GitHub 的執行長曾在訪談中提到，現在 GitHub 幾乎所有的文件都直接儲存在 GitHub 平台上。

這種做法的好處在於，透過 Git 的版本控制功能，可以輕鬆管理文件的版本，相較於許多外部文件系統，Git 的版本控制是內建的。此外，將技術設計文件放在程式碼庫中，能夠輕易將設計內容與實際的程式碼連結起來。當有人對某段程式碼有疑問時，可以直接在程式碼庫中找到相關的技術設計文件，能夠更輕易找到。

除此之外，在 AI 工具的輔助下，將技術設計文件放在程式碼庫中，還能讓一邊寫文件，一邊利用 Cursor。

情境一：發散技術設計想法

在撰寫技術設計文件時，可以透過 Cursor 及不同的 AI 模型，幫助自己發散出多種技術設計的觀點與想法。以聊天系統的基礎設計文件為例，假如原本的設計只支援純文字訊息。但產品經理提出新需求，希望在聊天系統中新增多媒體訊息 (如圖片或影音) 的傳送功能，這時就需要調整技術設計。

具體做法是，先將原本的技術設計文件作為脈絡，導入 Cursor 的對話框中，然後開始與 Cursor 進行技術設計上的腦力激盪。特別推薦在模型選擇上啟用「Thinking」模式。當面對技術設計這類需要縝密分析與思考的複雜問題時，使用推理模型的效果會更好。

接著，可以輸入相關需求作為提示詞，例如：「在這份聊天系統的技術設計文件中，原本只有純文字訊息，但 PM 希望增加多媒體訊息傳送功能，例如圖片或影音。請基於原本的技術設計，提供幾個不同的技術設計方案，以支援多媒體訊息傳送。」

將文件與提示詞送出後，Cursor 會根據需求生成回應。因為啟用了推理模型，AI 會先進行思考步驟，然後提供多個技術設計方案，並列出每個方案的優缺點，還會特別說明設計時需要考量的重點。例如，多媒體檔案（如圖片或影音）比純文字檔案更大，如何高效儲存這些檔案、優化效能，甚至確保安全性，都是需要特別注意的面向。

當然，推薦大家參考 Cursor 提供的建議時，仍需保持獨立思考。這些方案可以作為靈感來源，但不應全盤接受，而是要進一步完善自己的技術設計。

情境二：針對既有設計提供回饋

除了讓 Cursor 協助腦力激盪，如果你已經有某個技術設計方案，也可以請 Cursor 提供回饋，讓技術設計更縝密。以前面提到的聊天系統為例，文件中有群組聊天的設計，但原本的設計在擴展性上有局限，只能支援少量群組人數，當人數增加時會出現問題。

這時，可以選取這段文字，透過快捷鍵（如 Command + I）將其加入 Cursor 對話框，然後輸入提示詞，例如：「現在的群組聊天設計在擴展性上有局限，群組人數一多就難以支援。請提出設計上的不同觀點，來突破這個限制。」

與第一個情境不同，這裡不是從無到有生成新方案，而是針對既有設計請 Cursor 提供改進建議。送出提示詞後，Cursor 會進行推理並提出潛在方案，例如如何讓群組聊天支援更多人數。這些建議同樣推薦當作是腦力激盪的參考，需自行判斷其合理性與可行性，保持獨立思考至關重要。

情境三：生成圖表提升可讀性

在許多技術設計文件中，例如我們展示的這份聊天系統設計文件，若只有文字，讀者可能會覺得難以專注或理解。以這份文件為例，快速瀏覽後會發現全是文字，即使用 Markdown 格式預覽，雖然比純文字稍好，但仍不易閱讀。特別是一些概念，單靠文字很難讓人一目了然。

這時，可以透過 Cursor 生成圖表來提升可讀性。例如，文件中有一段描述一對一聊天訊息流程的文字，單純閱讀很難快速理解。過去可能需要手動繪製圖表，但現在利用 Cursor 可以輕鬆完成。具體做法是選取這段文字，加入 Cursor 對話框，然後輸入提示詞：「這段內容純文字很難讀，請加上 ASCII 圖示來協助說明。」送出後，Cursor 會生成一個 ASCII 圖表，可以直接複製並貼回設計文件中。

除了 ASCII 圖表，我們更推薦使用 Mermaid 這類繪圖工具。可以在 Cursor 中進一步輸入提示詞：「請基於這段內容生成 Mermaid 圖。」以一對一聊天流程為例，Cursor 會生成一個 Sequence Diagram 的 Mermaid 程式碼。將這段程式碼貼到 Mermaid 線上編輯器中，就能快速轉換成圖。將此類圖表加入設計文件中，能大幅提升可讀性，讓其他團隊成員更容易理解。

總結來說，寫技術設計文件時，強烈推薦搭配圖表，而透過 Cursor，可以輕鬆將文字轉換成 Mermaid 圖表，讓文件品質與可讀性顯著提升。

總結

透過這次展示，我們希望大家感受到 Cursor 在撰寫技術設計文件時的多種用途：從生成設計內容、針對既有設計提供觀點，到生成圖表提升可讀性，都能夠有效協助。未來撰寫技術設計文件時，可以多加利用 Cursor，讓文件寫得完整、好讀。

此系列文章為 《給工程師的 Cursor 工作流 — 透過 AI 代理全方位提升開發生產力》 搭配的教材。希望透過這系列文章，將過去協助導入 AI 工具及使用 Cursor 的經驗擴展並分享給想提升生產力的讀者。如果對課程感興趣的讀者，可以加入 E+ 成長計畫，觀看影片學習。