Aitishiku.com📌 Skill基础信息
- Skill名称：handoff（会话交接）
- 来源：社区第三方（ostikwhy-blip）
- 运行宿主：Claude Code CLI
- 核心定位：在Claude Code会话结束或出现退化时，通过创建/读取交接文档确保工作连续性，避免新会话重复已探索的错误路径。
🧩 内部核心组成
该Skill为逻辑控制型技能，不包含子Agent或MCP工具，主要通过规则引擎和文件操作实现核心功能：
核心组件：
- 模式检测机制：自动识别当前应执行CREATE模式（创建交接文件）或RESUME模式（从现有文件恢复）
- 防幻觉验证协议：强制要求所有声明必须通过实时验证才能标记为已验证
- 模板系统：使用预定义模板结构（
assets/HANDOFF.template.md） - 归档管理：自动将旧交接文件移动到
.handoffs/目录并维护版本历史
触发命令：
| 触发短语 | 功能描述 |
|---|---|
| create a handoff | 触发创建交接文档流程 |
| write a handoff | 触发创建交接文档流程 |
| I'm ending this session | 会话结束时的交接准备 |
| prepare for a fresh session | 为新会话做准备 |
| hand this off | 交接工作 |
| /handoff | 直接调用交接命令 |
🛠 安装与启用方式
安装命令：
skills install --user ostikwhy-blip/claude-code-handoff-skill前置要求：
- 运行在Claude Code CLI环境中
- 项目需为Git仓库（用于版本状态验证）
- 具备文件读写权限
启用方式： 安装后自动激活，通过特定触发短语或命令调用。
📋 标准工作流
- 触发检测：用户输入特定交接短语或会话出现退化迹象
- 模式判断：检查项目根目录是否存在
HANDOFF.md
- 存在且非本次创建 → 进入RESUME模式
- 不存在 → 进入CREATE模式
- CREATE模式流程：
- 归档现有交接文件（如存在）
- 执行防幻觉验证：重新读取所有相关文件、运行测试、验证Git状态
- 严格按模板生成交接文档，所有声明标注验证状态（[V]已验证/[?]未验证）
- 控制文档长度（≤250行，硬限制400行）
- RESUME模式流程：
- 完整阅读现有交接文档
- 重新验证所有声明是否仍然有效
- 向用户汇报状态差异和待解决问题
- 确认后续计划后继续工作
⚠️ 关键限制与注意事项
技术限制：
- 仅支持Git版本控制项目，非Git项目验证能力有限
- Token消耗较高（需重新读取和验证大量文件内容）
- 依赖Claude Code CLI的完整文件系统访问权限
使用限制：
- 不适合小型或简单项目（交接开销可能大于收益）
- 不适合实时生产环境（验证过程会产生延迟）
- 文档长度硬性限制可能导致重要信息被裁剪
已知注意事项：
- 必须在记忆退化时使用，正常会话中不建议频繁调用
- 所有声明必须实时验证，不能依赖记忆
- 不能自动执行，必须经过用户确认
✅ 适用场景 & ❌ 不适合场景
适用场景：
- 长时间会话后出现记忆退化或逻辑矛盾时
- 需要暂停工作并在新会话中继续的复杂项目
- 已探索多个失败路径需要避免重复的研发项目
- 多人协作项目中需要传递工作上下文的情况
不适合场景：
- 简单脚本或小型项目（交接成本过高）
- 实时生产环境或高可用性要求场景
- 非Git版本控制项目
- 会话初期或记忆清晰时（不需要交接）
如何安装
skills install --user ostikwhy-blip/claude-code-handoff-skill通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。