先列出使用者會期待外掛程式做到哪些事。外掛程式的名稱、說明、技能、工具,以及它與既有產品的關聯,都會影響使用者的期待。實作時應涵蓋這些需求。若決定不支援其中某項需求,應有明確的理由。
根據這些需求,決定外掛程式應包含哪些功能:
- 如果指示、範例或隨附的資源足以引導模型完成工作流程,就加入技能。
- 如果工作流程需要即時資料、身分驗證、受控工具,或需要在你維運的基礎設施上執行程式碼,就加入 MCP 伺服器。
- 只有在視覺化互動能明顯改善工作流程中的某個環節時,才為 MCP 伺服器加入使用者介面。
從使用者的期待出發
想像一位使用者已經安裝你的外掛程式,但還沒讀過說明文件。從這位使用者的角度來看,請外掛程式幫忙做哪些事是合理的?
從下列來源蒐集使用者可能提出的請求:
- 使用者目前已能透過你的產品或服務完成的任務。
- 使用者訪談、支援請求、搜尋查詢和功能需求。
- 使用者談到你的產品、資料和工作流程時常用的詞彙。
- 目前需要在不同工具之間複製資料的替代做法。
- 外掛程式的名稱、上架頁面和入門提示詞。
同時納入直接點名外掛程式的請求,以及只說明目標的間接請求。例如,專案管理外掛程式可能需要同時處理「顯示我的 Acme 上線看板」和「有哪些問題讓我們無法上線?」這兩種請求。
構思時,別只考慮現有 API 能支援的工作流程。先記下使用者的期待,再逐一評估哪些需求能安全、可靠地支援。
建立使用案例清單
為每個使用案例記錄以下內容:
| 欄位 | 要回答的問題 |
|---|---|
| 使用者目標 | 使用者想完成什麼事? |
| 請求範例 | 使用者可能會如何直接或間接提出請求? |
| 預期結果 | 這次互動要達成什麼結果才算成功? |
| 所需上下文 | 需要哪些資訊或帳戶存取權限?執行前必須處於什麼狀態? |
| 外掛程式功能 | 技能就能處理這項請求,還是需要 MCP 工具? |
| 安全界線 | 這項操作可能會暴露資料、變更狀態、支出款項,或影響他人嗎? |
| 支援決策 | 第一版會支援這個案例、延後支援,還是刻意排除? |
將目標相同的請求歸為一組。「列出我尚未完成的任務」、「我今天需要做什麼?」和「顯示逾期的任務」都可能屬於同一個檢視任務的使用案例,只需套用不同的篩選條件,無須分成三項各自獨立的功能。
檢查功能涵蓋範圍
逐項比對使用者的期待與規劃中的外掛程式功能:
- 確認每個支援的使用案例都有完整流程,能從使用者提出請求一路執行到產生有用的結果。
- 找出缺少的技能、工具、資料或權限,以及尚未處理的錯誤狀態。
- 找出哪些工具只提供技術操作,卻無法幫助使用者達成明確的目標。
- 確認寫入操作有適當的授權與確認機制。
- 確認外掛程式能說明自己做不到哪些事,並提出有用的下一步建議。
如果外掛程式只能支援預期工作流程中的一小部分,就不應讓使用者以為它具備廣泛的功能。例如,如果使用者可以建立專案,卻無法列出、檢視或更新專案,就應補齊缺少的功能,或縮小外掛程式對外宣稱的功能範圍。
記錄刻意排除的使用案例
你不必實作所有想得到的請求。對於每一項重要但決定排除的需求,都應有充分的理由,例如:
- 該操作會造成無法接受的安全或隱私風險。
- 底層產品或 API 無法可靠地支援該操作。
- 工作流程需要某些權限,但外掛程式無法驗證使用者是否具備這些權限。
- 外掛程式無法存取必要資訊,缺少這些資訊會使結果誤導使用者。
- 該使用案例不在首版的支援範圍內,而且外掛程式的上架頁面已清楚說明這項限制。
記下這些決定。界定技能範圍、撰寫工具說明、設計拒絕請求時的回應方式、編寫測試案例,以及撰寫公開上架頁面的文案時,都應以這些決定為依據。
根據使用案例決定實作方式
針對每個要支援的使用案例,選擇足以完成它的最精簡實作方式:
- 建置技能,提供可重複使用的指示和資源。
- 建置 MCP 伺服器,取得即時資料並執行受控操作。
- 當使用者需要檢視、比較、編輯、確認或瀏覽結構化資訊時,為 MCP 伺服器加入使用者介面。
保留使用案例清單,作為測試計畫。加入具代表性的直接請求、間接請求、涉及邊界情況的請求,以及超出支援範圍的請求。完成外掛程式後,逐一驗證它處理這些請求時的行為是否符合預期。
如果外掛程式需要即時資料或受控操作,請接著閱讀定義工具。