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+ 成长计划，观看影片学习。