SuperAPI AI 工具集

handoff-update

办公与效率

查看项目

更新于 10-16 05:47

技能介绍

用途:更新已有的 handoff 交接文档,把本次会话的进展合并进去,便于跨会话延续工作。

主要能力与合并规则:Task 保留原文,仅在范围根本变化时更新;Scope 保留或细化;Files 合并,新增本次触及的文件并保留原有条目,使用 path:line 格式;Discoveries 追加,新发现写在已有列表下方,不删除旧发现;Work Done 严格只追加,新完成项写在下方并包含 commit hash,即使旧条目描述的工作后来被修改也保留,改为新增一条描述修订;Status 替换为当前状态(已完成、剩余、测试状态);Next Steps 替换为更新后的可执行清单;Code 更新为当前状态下最相关的代码片段。

使用方式:第一步确定要更新的文件,优先级为:若提供了 $ARGUMENTS[0] 则作为文件路径;若本次会话由 /handoff:resume 启动,则在对话历史中查找传给它的参数;两者都没有时,回退为新建 claudedocs/handoffs/handoff_YYYYMMDD_HHMMSS.md,并告知用户未找到已有交接文档。第二步完整读取该文件,解析所有分区作为合并基线。第三步按上述规则重写文件。第四步保存后确认:更新的文件路径、新增的 Work Done 条目数、更新后的 Status(一行)、剩余 Next Steps 数量。

适用场景:需要在多次会话之间传递任务上下文、保留完整工作历史的开发流程。该命令实现本指南 Session Handoff Pattern 中记录的 Handoff Triad 模式,模板灵感来自 Packmind 的 handoff 命令(Apache 2.0)。

限制:资料未提供更多平台、收费或效果信息。