在 DeepSeek Harness 中，長項目往往死在聊天記錄裏。關鍵上下文會滾動消失、被壓縮，或者屬於已結束的會話。爲了讓下一個會話能夠立即恢復工作，而不需要“考古”查找歷史記錄，需要建立一套交接紀律。Project Handoff 技能將這套紀律固化爲可複用的流程。
這是一個記憶類技能，由 ChenneyZhuang 維護，開源協議爲 MIT。它解決的核心問題是：如何將決策理由、潛規則和當前狀態持久化地保存在項目內部，而不依賴臨時的對話壓縮。
核心功能¶
該技能在項目目錄下生成一個持久化的 handoff.md 文件，內容包含三個核心部分：
- 當前狀態：記錄存在的實體、數量、路徑和版本，僅包含可覈驗的聲明。
- 決策與理由：記錄“爲什麼選擇 X 而不是 Y”，保留決策背後的邏輯，避免後續重開爭議。
- 陷阱記錄：嚴格採用“症狀 → 原因 → 修復”的格式記錄已知的坑，便於長期閱讀和檢索。
技能支持中英文雙語，文件隨項目版本控制，即使在沒有對話產生時也存在。
安裝與啓用¶
通過 npm 命令安裝：
npx skills add ChenneyZhuang/project-handoff
不同 agent 的具體安裝路徑請參考項目中的 COMPATIBILITY.md 文件。
典型用法¶
- 工作前核驗：開始處理現有項目前，先閱讀
handoff.md。對比文件中的聲明與實際項目狀態，修正過時的條目。 - 變更時立即更新：里程碑達成、做出關鍵決策或發現坑時，立即寫入文件。不要等到一天結束時再整理，過時的交接文件就是謠言。
- 使用標準陷阱格式：記錄問題時，必須按“症狀 → 原因 → 修復”的順序編寫，確保文件在幾週後仍具可讀性。
- 保護敏感信息：不要在
handoff.md中直接寫入憑證或個人隱私。將這些信息存儲在專用存儲中，並在交接文件中指向該位置。
適用場景與注意¶
- 適用場景：適用於跨會話工作、多人員協作的項目。單人短週期項目可能不需要這種嚴格的紀律。
- 侷限說明：這是一個記憶層工具，不是版本控制（git）的替代品。代碼歷史歸 git 管理，
handoff.md僅記錄 git 無法存儲的內容（如決策理由、未寫明的規則）。 - 風險提示：過期的條目與缺失的條目一樣會誤導。由於文件記錄的是寫入時刻的事實，帶有日期的條目需要讀者在閱讀時進行現實覈驗。對於日期早於最近大變更的條目應保持懷疑。
