SuperAPI AI 工具集

handoff

通用与其它

查看项目

更新于 10-16 03:14

技能介绍

用途:当会话上下文即将耗尽、需要在新会话中继续工作时,用 handoff 生成一份可读、可修改的交接文件 handoff.md;在新会话中再读回它,校验后从记录的下一步继续。它针对的是 /compact 摘要不可编辑、--continue/--resume 重新付出上下文成本、/clear 不携带任何状态之间的空隙:交接状态是一个人类可读、可在被依赖前纠正的文件。

主要能力:调用时先声明“Running paad:handoff v2.0.0”再执行;支持 /handoff(按上文有无对话推断保存或恢复)、/handoff save、/handoff resume。保存流程会检查 .gitignore 是否忽略 handoff.md(只建议添加,不擅自修改),用工具核验可查证的事实(当前提交、分支、脏状态、上次提交内容、文件路径、行号、测试名、测试是否通过、引语出处),无法核验的标记为推断;用 Write 工具写文件,包含 Goal、Decisions、Ruled out、Constraints、Next step、Verify、Unverified 等段落;最后点名最不确定的声明请用户复核,并列出写入的文件。恢复流程读取 handoff.md、简短总结、比对记录提交与 HEAD 的漂移、询问是否继续、核验文件与状态、报告不一致后再开始记录的下一步,且从不删除 handoff.md。

限制与注意:配置为实验性,会检查 paad/config/paad.md 与 paad/config/handoff.md,配置不能改变子代理类型或授予写权限;不要用 shell 重定向写文件;不要凭记忆写路径、行号或测试名;不要写架构综述或会话叙事;不要以泛泛的“请审阅”收尾;不要用它来压缩当前会话(那是 /compact)。