用途:在当前仓库根目录创建或刷新 NEXTUP.md,作为单一当前快照(而非历史日志),让用户切换上下文后能恢复工作。
主要能力:从当前智能体会话中重建停止点,包括用户目标、已完成工作、决策、失败尝试、验证结果、未完成事项与开放问题;检查仓库的当前分支、工作树状态、近期相关提交及差异或变更文件;读取已有 NEXTUP.md 以保持连续性,只保留仍然有效有用的上下文并重写为当前快照。区分已验证完成、进行中和仅建议的内容,不确定处如实说明,不把缺失上下文当作事实重建,并避免将机密和敏感个人数据写入持久文件。
使用方式:用 git rev-parse --show-toplevel 解析仓库根目录;不在 Git 中则使用当前工作目录。写入时从环境获取当前本地时间,使用含日期、时间、时区缩写和 UTC 偏移的时间戳,例如 2026-08-26 14:30:00 EDT (UTC-0400)。文件结构包含标题、Last updated、Repository、Branch,以及 Where I left off、Completed、In progress、Recommended next steps、Open questions and blockers、Resume context 等小节。建议下一步写 1 到 3 条,按连续性和杠杆排序,第一条必须可直接从记录状态执行,并引用已有规格、issue、提交和文件而非复制其内容。
适用场景:需要在会话之间保留工作上下文、恢复中断任务、明确下一步行动时。
限制:当会话中没有足够近期工作可识别停止点时,应说明未知并建议最小的检查或决策来恢复;运行完成的标志是 NEXTUP.md 具有新时间戳、涵盖当前智能体窗口中每个有意义的开放线索、与仓库状态一致,并给出具体的第一步行动,最后报告文件路径和第一条建议。