Community生产力与协作github.com

chunyun1998-sudo/session-handoff

会话交接文档生成 Skill:让新 AI 会话无缝接手 / Session handoff document skill

session-handoff 是什么?

session-handoff is a Claude Code agent skill that 会话交接文档生成 Skill:让新 AI 会话无缝接手 / Session handoff document skill.

兼容平台~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 — Session Handoff Document Generation

When to Invoke

When Chunyun (or any user) says any of the following keywords, this Skill must be invoked immediately:

  • "会话交接" (session handoff)
  • "会话整理" (session organization)
  • "交接文档" (handoff document)
  • "做交接" (do handoff)
  • "session handoff"
  • "handoff"
  • "生成交接" (generate handoff)
  • "会话总结" (session summary)
  • Any expression indicating "this session is ending, and the next session’s person/AI needs to know what happened"

Objective

Generate a structured Markdown handoff document and save it to the workspace root directory. The document must allow an AI or human with no prior context to accurately take over after reading it.

Output Specification

File Name Format

会话交接文档_主题名_YYYYMMDD_vN.md
  • 主题名 = Core task or theme extracted from the conversation context, suggested 2–6 Chinese words, remove colons, dashes, and other special characters, connect words with underscores. If no clear theme can be extracted, use 未分类
  • YYYYMMDD = Current date
  • vN = Version number, starting from v1. If a document with the same date and theme already exists in the workspace, increment the version number

Eight Mandatory Sections

#SectionMust Cover
1Session SummaryGoal of this session, time period, list of main achievements
2Latest User PersonaExtract from user_rules; if no rules exist, infer from conversation and note as "Inferred"
3Completed WorkWhat was done specifically, which files were produced (attach file paths and names), key data or results
4Current ProgressCurrent status: what has been confirmed, what remains to be progressed
5Unresolved IssuesBlockers, pending decisions, items requiring further investigation, legacy technical debt
6Rules and ConstraintsNewly confirmed non-changeable boundaries from this session (naming conventions, forbidden words in writing, tool limitations, etc.)
7Handoff Guide for New SessionWhat the first step should be, where to start, any notices
8Original Dialogue Appendix (Optional)Key dialogue excerpts or quotes to help the new AI understand context

Writing Requirements

  1. User Information First: If user_rules contains Chunyun’s persona (occupation, preferences, tool ecosystem, writing conventions, etc.), quote them fully in Section 2, do not omit anything
  2. Full File Paths: All mentioned output files must include the full path relative to the workspace
  3. Explicitly Mark Exceptions: If any information is inferred (not explicitly stated by the user), annotate it with "🤖 Inferred"
  4. Follow User Language: The handoff document must use the language Chunyun is currently using

Workflow

User triggers (e.g., "帮我做会话交接" [help me do session handoff])
  ↓
① Scan workspace root directory file list
② Read user_rules to get persona and fixed preferences
③ Review current conversation context, extract key information
④ Extract session theme name (2–6 Chinese words, for file name)
⑤ Organize content into the 8 sections above
⑥ Save to workspace following naming convention
  ↓
Notify user that document has been generated and provide file link

Usage Example

User says: "帮我做个会话交接" (Help me do a session handoff)

AI should:

  1. Immediately invoke this Skill
  2. Scan workspace files
  3. Review conversation context
  4. Extract theme name, e.g., 公众号长文优化 (public account long article optimization)
  5. Generate 会话交接文档_公众号长文优化_20260719_v1.md
  6. Reply: "春云,交接文档已生成:[链接]" (Chunyun, the handoff document has been generated: [link])

User says: "整理一下当前的进度,后面的人来接手" (Organize the current progress, someone will take over later)

AI also triggers this Skill and generates a standard handoff document.

相关技能