Skip to content
所有文章 ‹ Part 01 of 08 · 設計 Agent 與 Agent Loop:先切 FR 與 NFR
工程 · 1 min read

先寫意圖,不先寫 prompt

Agent 做不好,常常不是 prompt 的問題,而是沒人說清楚它為什麼存在。先寫一句意圖,再回答 Workflow、Boundary、Knowledge、Cost、Trust 五個問題。

我幫團隊設計一個知識庫 agent。它要把散在程式碼、文件、聊天紀錄的知識整理起來。第一版目標寫完,我在旁邊加了一行註記:「目的還是不夠清楚」。

那行註記提醒我:agent 做不好,常常不是 prompt 不好,而是沒人說清楚它為什麼存在。

意圖,加上五個問題

意圖是一句話:「這個 agent 存在,是為了讓誰做到什麼」。有了這句話,再回答「大大帶我飛」的演講裡的五個問題:

意圖為什麼要有它 Workflow放進哪一段工作流程?誰提問?結果給誰? Boundary可以看什麼、改什麼?何時要人核准? Knowledge知識在哪?怎麼找、怎麼篩、怎麼放進 context? Cost哪一步最貴?能 cache、換便宜模型、或延後嗎? Trust留下什麼 trace?怎麼驗證,團隊才敢用?
上面一句意圖,下面五個問題。

我怎麼補上意圖

我沒有直接改目標。我先列出每種使用者要這個 agent 做什麼:寫程式的人要它讀程式碼和紀錄,維護知識的人要單一來源和權限控制,只想查資料的人要最新、正確、附來源的答案。

列完之後,意圖就浮出來了。每個需求也自然落到五個問題的其中一格。之後要決定哪些步驟寫成 script,哪些交給 LLM,就容易多了。這一步我寫在Agent 設計就是 FR 與 NFR 的切分。

練習

有人問:「上週新用戶的啟用率為什麼下降?」agent 要找資料定義、查相關的表、產生 SQL、檢查結果,最後整理結論與限制。先寫一句意圖,再用五個問題設計一個最小可行的版本。

寫不出一句意圖,就還不能開始寫 prompt。


參考來源:

  • 「大大帶我飛」的演講

延伸閱讀: 看看意圖清楚之後,怎麼做 FR 與 NFR 的切分。或回到系列總覽:設計 Agent,先切 FR 與 NFR。

// connect

Be brave | Be wise | Be grateful

21 BreakinCode

// elsewhere
LinkedInMedium (lang: en)Youtube
wh:~$William Hung· © 2026 Taipei · GMT+8 · ● Available for collaboration
↑↓ 移動 ↵ 開啟 esc 關閉