SuperAPI AI 工具集

sw/handoff

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

用途:不同 AI 编程工具无法互读会话记录(各自使用专有 .jsonl、SQLite 或加密 .pb),因此唯一可移植的载体是自包含的交接文档。本技能把 SpecWeave 的磁盘持久状态(活动增量、任务/验收标准进度、决策、环境规则)与未提交改动的完整 diff 汇总成一份文档,供其他工具接着做。它是跨工具交接功能在 Claude Code 上的入口,确定性引擎是 specweave handoff CLI 子命令,同一引擎也支撑 PreCompact 自动交接钩子和 vskill handoff 技能。

主要能力:生成含固定章节的文档(Where I Left Off、Done/Pending、Key Decisions & Gotchas、Files Touched、Exact Next Steps、How To Resume、Redaction),并输出配套 .diff 文件;默认对文档和 diff 做密钥脱敏并加入 gitignore,不提交任何内容。

使用方式:运行 specweave handoff [incrementId] [--reason ...] [--summary ...] [--next ...] [--gotcha ...] [--decision ...] [--inline]。无 incrementId 且仅一个活动增量时自动选用;无活动增量时写 git + 简短访谈式交接;多个活动增量且未指定 id 时报错并列出候选。随后按顺序原样展示 CLI 输出:文档绝对路径、可点击链接、.diff 路径、可粘贴的恢复提示、各工具查找源会话的提示。

适用场景:订阅 token 将耗尽需换工具继续、担心会话在上下文耗尽时中断、换机器(用 --inline 让完整文档随粘贴提示一起走)。

限制:脱敏为启发式,分享前需人工复核;文档位置在 SpecWeave 下为 .specweave/increments/{id}/reports/handoff.md 及 .specweave/state/handoff-latest.md,非 SpecWeave 下为 .handoff/HANDOFF.md 与 .handoff/handoff.diff。其他收费、平台与效果信息暂未提供。