Agent 交接文檔怎麼寫:會話交接說明提示詞(上下文快滿或換人接手時,讓下一個智能體不用重新摸索)

一個長任務做到一半,對話上下文快滿了、要開新會話,或要把活交給另一個智能體或同事繼續時用:讓當前的智能體按固定結構寫一份交接說明,寫清目標、已完成並驗證的部分、做到一半的狀態、踩過的坑、下一步和不能碰的東西,新會話讀完就能接着幹。

NNathaniel bigo··原創首發·AI 輔助撰寫
通用大模型 對話模型通用
你即將結束這次會話,接下來會由一個看不到本次對話的新智能體(或新會話裏的你)繼續這項工作。請寫一份交接說明。它只會讀到這份說明和工作目錄裏的文件,所以凡是隻存在於本次對話裏的資訊,都必須寫進去。

補充資訊:
- 交接原因:[交接原因]
- 接手方(新會話、另一種智能體、人):[接手方]
- 交接說明儲存的位置:[儲存位置]
- 我特別想強調的事:[特別提醒]

請按以下結構寫,每節都要有,沒有內容的寫「無」:

1. 目標與完成標準:用戶最初要什麼(盡量引用用戶原話),做到什麼程度算完成,哪些是明確說了不做的。
2. 當前狀態一句話:例如「5 個子任務完成 3 個,第 4 個改了一半,測試未跑」。
3. 已完成並驗證的部分:逐條寫做了什麼、涉及哪些文件或對象、用什麼方式驗證過(命令與結果)。只做了沒驗證的,放到第 4 節,不要寫在這裏。
4. 進行中與未驗證的部分:停在哪一步、已經改動但未完成的文件、當前處於不一致狀態的地方(例如遷移跑了一半)。
5. 關鍵決定與理由:做過的取捨,以及用戶明確表達過的偏好和禁令。接手方最容易推翻的決定要寫清為什麼不能改。
6. 試過但行不通的路:嘗試了什麼、失敗現象、為什麼放棄,避免接手方重走一遍。
7. 環境與操作須知:怎麼啟動、怎麼測試、用到的命令、需要的權限或憑據放在哪裏(只寫位置,不寫憑據內容)、耗時長或有副作用的操作。
8. 下一步:按順序列出接下來 3–5 個具體動作,第一個動作要具體到可以直接執行。
9. 待用戶確認的問題:列出需要人來決定的事項及各選項的影響。
10. 不要做的事:可能造成損害或違背用戶意願的操作清單。

寫作要求:
- 區分三種說法:「已驗證」「我認為但未驗證」「不知道」,不要把推測寫成事實。
- 寫路徑、命令、標識符時用原文,不要用「那個配置文件」這類指代。
- 篇幅控制在一屏半以內;細節多的內容指向文件位置而不是全文複述。
- 寫完後自查:一個完全沒看過本次對話的人,只憑這份說明能否開始第 8 節的第一個動作?不能就補全。

高亮處換成你自己的內容:[交接原因]、[接手方]、[儲存位置]、[特別提醒]

ChatGPT Plus 充值

已被複製 0 次

使用說明

怎麼用:在長會話快結束時把整段提示詞發給當前的智能體。[交接原因] 寫「上下文快滿」「今天先到這裏」「換另一個工具繼續」之類;[儲存位置] 建議寫成工作目錄裏的一個文件(如 docs/handoff.md),新會話第一句話就是「先讀 docs/handoff.md 再繼續」。[特別提醒] 寫你最怕被忘掉的那件事,比如「生產數據庫只讀,任何寫操作先問我」。

常見失敗與調整:

  • 把「寫了代碼」寫成「已完成」。提示詞裏專門區分了已驗證和未驗證,交接後發現不符,就讓它補上驗證命令和輸出。
  • 交接說明只是對話流水帳。要求按十節結構重寫,重點是狀態和下一步,而不是過程。
  • 遺漏用戶說過的禁令。在第 5、10 節不夠時追問「回顧本次對話,用戶說過哪些不要做」。

追問:「把這份交接說明壓縮成新會話可用的開場提示詞」「對照交接說明,列出你現在最不確定的三件事」。

與上下文管理方案的區別:站內的上下文工程提示詞是設計應用層面的方案;本條是此刻就要寫出來的那份交接文檔。

示例輸出

示例,僅供參考(虛構任務:給訂單導出功能增加按日期篩選)

2. 當前狀態:後端接口已完成並通過測試;前端日期選擇器改了一半;端到端測試未跑。

3. 已完成並驗證

  • src/api/orders/export.ts 增加 from、to 參數;運行 npm test -- export 共 12 項全部通過。

4. 進行中與未驗證

  • src/pages/orders/ExportDialog.tsx 已加入日期選擇器,但「結束日期早於開始日期」的校驗還沒寫;我認為時區按本地時間處理即可,但未驗證。

6. 試過但行不通的路

  • 試過在數據庫層用字符串比較日期,跨月時結果錯誤,已放棄,改為按時間戳比較。

8. 下一步

  1. 在 ExportDialog.tsx 補上日期先後校驗,並為它寫一個組件測試。
  2. 運行 npm run e2e -- orders 做端到端驗證。

10. 不要做的事:不要修改 prisma/schema.prisma,用戶明確說這次不動表結構。

同款作品

用這條提示詞做出來的作品;原作者會因此獲得積分

做同款

還沒有同款,來做第一個。

Nathaniel 的更多內容

同主題

同模型

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~