用途:在结束未完成的长会话、切换任务或分支、上下文过大可能被压缩、或将工作交接给他人或其他智能体前,把当前会话状态整理成结构化交接文档,记录目标、决策、进度和下一步。
主要能力:通过 /superpowers-ruby:handoff 创建完整交接文档,/superpowers-ruby:handoff-resume 从最近交接恢复,/superpowers-ruby:handoff-list 列出可用交接。文档输出到 docs/handoffs/YYYY-MM-DD-<topic>.md,归档到 docs/handoffs/_archive/。文档含 Goal、Current State、Key Decisions、Modified Files、Failed Approaches、Files to Read、Next Steps、Open Questions 等分节,并带 created、branch、trigger、restored、topic 元数据。因是 docs/handoffs/ 下的普通 markdown,可跨智能体使用。
使用方式:先运行 git diff --name-only、git status --porcelain,并检测 .claude/plans/.md、docs/superpowers/specs/.md、docs/superpowers/plans/*.md 等计划文件;再据当前工作生成简短 topic slug;然后创建文档并填满各分节;最后确认保存位置。Claude Code 通过 PreCompact hook 在压缩前自动运行,OpenCode 通过 experimental.session.compacting 事件触发;Codex 无压缩钩子需手动使用。
限制:工作已完全完成时改用 finishing-a-development-branch,记录已解决问题时改用 compound。钩子自动生成的文档只含机械状态,需由后续步骤补充 LLM 相关分节。其他平台或收费信息暂未提供。