用途:在运行 /clear 前创建或更新连续性账本(YAML 交接文档),把当前会话的目标、进展、决策与后续步骤保存下来,供新会话恢复上下文。该技能现为 /create_handoff 的别名,两者输出相同 YAML 格式。
主要能力:生成固定字段的 YAML 交接文件,包含 goal、now、test、done_this_session、blockers、questions、decisions、findings、worked、failed、next、files 等;其中 goal 与 now 会显示在状态栏,字段名必须完全一致。文件路径为 thoughts/shared/handoffs/{session-name}/YYYY-MM-DD_HH-MM_description.yaml,会话名取自最近修改的交接文件夹,若无则用 general。
使用方式:先用 ls -td thoughts/shared/handoffs/*/ 2>/dev/null | head -1 | xargs basename 确定会话名;按指定格式写入约 400 tokens 的 YAML;随后必须用 AskUserQuestion 询问会话结果(SUCCEEDED、PARTIAL_PLUS、PARTIAL_MINUS、FAILED),并用 uv run python scripts/core/artifact_mark.py --latest --outcome <USER_CHOICE> 标记;最后提示用 /resume_handoff path/to/handoff.yaml 恢复。
适用场景:运行 /clear 前、上下文接近 70% 以上、跨多天实现、复杂重构、预计达到 85% 以上上下文的会话。
限制:不适合 30 分钟内的快速任务、简单缺陷修复或单文件改动。资料未提供收费、平台与效果信息。