Warm handover
Skill zgjq/warm-handover
Transform a colleague departure into a structured, warm, and living knowledge transfer. The human alternative to colleague-skill. Use when: (1) someone is leaving the team and needs to hand over their work, (2) a new person is taking over an existing project, (3) you want to capture tribal knowledge before it walks out the door, (4) a team member is transitioning roles internally. NOT for: scraping chat logs to create an AI clone of a person.From its SKILL.md
npx -y skills add zgjq/warm-handoverAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 2 commands, including `python3 scripts/handover_interview.py` and 1 more.
SKILL.md
2.3 KB, 695 tokens by cl100k_base, as published. Nobody here has run it
Warm Handover
"冰冷的离别化为温暖的 Skill" — 但真正的温暖不是模仿死人,而是让活人好好交接。
colleague-skill 的做法:爬聊天记录 → 生成 AI 替身 → 假装他没走。 Warm Handover 的做法:引导式访谈 → 结构化知识 → 让接手者真正能干活。
How It Works
Phase 1: Guided Interview
Run a structured handover interview with role-based templates:
# CLI mode
python3 scripts/handover_interview.py
# Web mode
cd web && npm run dev
# Open http://localhost:3000
Phase 2: Structured Output
Generates four files:
PROJECT.md— 项目全景、架构、关键决策PEOPLE.md— 人脉地图、协作网络LESSONS.md— 经验教训、踩坑记录TODO.md— 待办清单、已知问题
Phase 3: Living Document
- 接手者每遇到新问题,更新对应文件
- 每月回顾 LESSONS.md,把个人经验变成团队知识
- 3 个月后评估交接质量
Why This Beats Colleague-Skill
| Colleague-Skill | Warm Handover | |
|---|---|---|
| 数据来源 | 爬聊天记录(冰冷、被动) | 引导式访谈(温暖、主动) |
| 知识质量 | 噪音为主,缺乏上下文 | 结构化、经过思考 |
| 输出 | AI 替身(ELIZA 效应) | 交接文档(实用、可追溯) |
| 持续性 | 静态快照,过时即废 | 活文档,持续更新 |
| 法律风险 | 可能侵犯隐私 | 完全合规 |
| 界面 | CLI only | Web UI + CLI |
Philosophy
colleague-skill 的核心假设是:一个人的价值 = 他的聊天记录。 这是对人最大的不尊重。
Warm Handover 不制造 AI 替身。它帮助一个人好好告别,帮助另一个人好好开始。
References
references/interview-templates.md— 不同角色的定制化访谈模板references/handover-checklist.md— 完整的交接清单和时间线管理
What ships with it: 5 files
15.8 KB alongside SKILL.md, 1 of them executable
references/
- handover-checklist.md1.7 KB
- interview-templates.md1.8 KB
scripts/
- handover_interview.pyruns5.2 KB