Community生產力與協作github.com

chunyun1998-sudo/session-handoff

生成結構化 Markdown 交接文檔,讓新 AI 會話或人類無縫接手當前工作。

session-handoff 是什麼?

此技能專為 AI 代理(如 Claude Code、Cursor、Codex)設計,用於在會話結束時自動產生一份完整的結構化 Markdown 交接文檔。技能會在觸發關鍵字(如「會話交接」、「handoff」)時被調用,掃描工作區檔案、讀取 user_rules 中的使用者資訊,並回顧當前對話上下文,提煉出核心主題與完成進度。最終產出的文檔包含8個必要章節:會話概要、使用者最新畫像、已完成工作、當前進度、未解決問題、規則與約束、接續指南,以及可選的原始對話附錄。這份文檔能讓下一個 AI 或人類開發者在不了解前情的情況下,準確快速地接手工作任務,有效提升團隊協作與長期專案開發的效率。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add chunyun1998-sudo/session-handoff

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Session Handoff — 會話交接文件生成

什麼時候調用

當春雲(或任何用戶)說出以下關鍵詞時,必須立即調用本 Skill:

  • 「會話交接」
  • 「會話整理」
  • 「交接文件」
  • 「做交接」
  • 「session handoff」
  • 「handoff」
  • 「生成交接」
  • 「會話總結」
  • 任何表示「當前會話要結束了,下一個會話的人/AI 需要知道發生了什麼」的意思

工作目標

生成一份 結構化 Markdown 交接文件,保存到工作區根目錄。文件必須確保一個完全不了解前情的 AI 或人類讀完即可準確接手。

輸出規範

文件名格式

會話交接文件_主題名_YYYYMMDD_vN.md
  • 主題名 = 從會話上下文中提煉的核心任務或主題,建議 2-6 個中文詞,去除冒號、破折號等特殊符號,詞與詞之間用底線連接。如果無法提煉出明確主題,使用 未分類
  • YYYYMMDD = 當天日期
  • vN = 版本號,從 v1 開始。如果工作區已存在同日期且同主題的文件,遞增版本號

必須包含的 8 個章節

#章節必須覆蓋的內容
1會話概要本次會話的目標、時間段、主要成果清單
2用戶最新畫像從 user_rules 中提取;如無規則則根據對話推斷並註明「推斷」
3已完成的工作具體做了什麼、產出了哪些檔案(附檔案路徑和檔案名稱)、關鍵資料或結果
4當前進度做到哪一步了、哪些已確認、哪些待推進
5未解決問題卡點、待決策事項、需進一步調研的內容、遺留的技術債務
6規則與約束本會話中新確認的不可改動的邊界(命名規範、寫作禁用詞、工具限制等)
7新會話接續指南下一步第一件事應該做什麼、從哪裡開始、有哪些注意事項
8原始對話附錄(可選)關鍵的對話片段或引用,幫助新 AI 理解上下文

寫作要求

  1. 用戶資訊優先:如果 user_rules 中有春雲的畫像資訊(職業、偏好、工具生態、寫作規範等),直接在章節 2 中完整引用,勿遺漏
  2. 檔案路徑完整:所有提到的產出檔案,附帶相對於工作區的完整路徑
  3. 明確標注意外:如果某些資訊是透過推斷得到的(而非用戶顯式告知),必須在旁邊標註「🤖 推斷」
  4. 語言跟隨用戶:交接文件使用春雲當前使用的語言

工作流程

用戶觸發 (如"幫我做會話交接")
  ↓
① 掃描工作區根目錄檔案清單
② 讀取 user_rules 獲取畫像與固定偏好
③ 回顧當前對話上下文,提取關鍵資訊
④ 提煉會話主題名(2-6 個中文詞,用於檔案名稱)
⑤ 按上述 8 個章節組織內容
⑥ 按命名規則保存到工作區
  ↓
告知用戶文件已生成並提供檔案連結

使用範例

用戶說:「幫我做個會話交接」

AI 應該:

  1. 立即調用本 Skill
  2. 掃描工作區檔案
  3. 回顧對話上下文
  4. 提煉主題名,例如 公眾號長文優化
  5. 生成 會話交接文件_公眾號長文優化_20260719_v1.md
  6. 回覆:「春雲,交接文件已生成:[連結]」

用戶說:「整理一下當前的進度,後面的人來接手」

AI 同樣觸發本 Skill,生成標準交接文件。

相關技能