用途:在工作会话结束、需由后续智能体接手,或用户要求交接、上下文包时,将计划、进度、结果、日志与仓库现状编译成接手者可直接使用的交接材料,而非会话流水账。
主要能力:生成并保持一致的 handoff.md 与 context-pack.json,统一整体状态;区分事实、推断与未知,事实须引用来源,推断需标注并附支持证据;用 references/handoff-source-priority.md 解析来源优先级与冲突,只有优先级和决胜规则无法解决时才记录冲突;按 references/handoff-quality-gate.md 判定状态,完成声明需有文件、命令、测试等可检查证据;按 references/continuation-mode.md 选择继续形态,默认单条顺序路径,仅在剩余轨道确实独立且并行收益大于成本时并行,并给出独立轨道、依赖、写入归属、串行门与建议角色。
使用方式:收集 plan.md、progress.md 或 task.md、result.md、相关日志与当前仓库状态;工件不明显时运行 scripts/build_handoff_index.py <artifact_dir>;填写 assets/templates/handoff.template.md 与 assets/templates/context-pack.template.json;运行三个校验器直至全部退出 0: python3 scripts/validate_handoff_md.py <handoff.md> python3 scripts/validate_context_pack.py <context-pack.json> python3 scripts/validate_handoff_parity.py <handoff.md> <context-pack.json> 最后交付两条路径、整体状态、证据缺口与首个后续动作。无交付工件时,可依据 git status、git diff、提交历史、变更文件等实时仓库证据编译;会话记忆仅在标注未验证时可补充上下文。
限制:状态词表与 JSON 形状仅以 references/context-pack-schema.md 为准,不得自造同义词;两个输出的整体状态必须一致;缺少或冲突的关键证据会降低整体状态,文字信心不能替代证明;校验通过只证明结构而非事实真伪,决定性声明需回源复核;不得默认模板为并行工作,parallel_recommended 需先通过独立性测试;progress.md 与 task.md 状态不一致时须选定权威来源并记录冲突;脚本仅用 Python 3 标准库,路径相对技能目录。适用场景:会话交接、上下文包、跨代理继续任务。其它细节暂未提供。