SuperAPI AI 工具集

session-handoff

智能体与模型

查看项目

更新于 10-15 20:21

技能介绍

用途:为 AI 智能体会话交接生成完整文档,使新会话能无缝继续工作,解决长任务上下文耗尽问题。

主要能力:区分创建与恢复两种模式;创建时用脚本生成预填脚手架,包含时间戳、项目路径、git 分支、近期提交和修改文件;恢复时列出可用交接、检查陈旧度并加载上下文;支持交接链,用 --continues-from 链接前序文档。

使用方式:创建运行 python scripts/create_handoff.py [task-slug],续接加 --continues-from 2024-01-15-auth.md;填写所有 [TODO: ...] 段落后运行 python scripts/validate_handoff.py <handoff-file> 校验,存在密钥或评分低于 70 不应定稿。恢复时先运行 python scripts/list_handoffs.py,再用 python scripts/check_staleness.py <handoff-file> 检查陈旧度(FRESH、SLIGHTLY_STALE、STALE、VERY_STALE),然后完整阅读文档并按 references/resume-checklist.md 核对,从“Immediate Next Steps”第一项开始。

适用场景:长周期项目、复杂调试、重大决策后保存上下文,或需要跨会话继续工作时。

限制:文档存于 .claude/handoffs/,命名 YYYY-MM-DD-HHMMSS-[slug].md;需按模板填写,校验会检测密钥、占位符和引用文件;陈旧度过高时建议重新创建。具体安装与依赖信息暂未提供。