开发会话断点续作
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/alinaqi-maggy-session-management。
技能介绍
问题背景
和 AI 结对写代码时,一次会话往往跨越多轮工具调用:改几处文件、做架构取舍、再切到另一块模块。中断一段时间后回来,或对话快到上下文上限时,模型常丢失「正在做什么、哪些路已经试过、为什么选了 A 而不是 B」。没有可读的会话状态,每次重启都等于从零摸索。
技能如何工作
核心理念是 在自然断点做检查点,回来后立刻接上。技能要求在仓库里维护 _project_specs/session/ 目录,用几类文件分工:current-state.md 记录当前任务、进度与下一步;decisions.md 只做追加的决策日志;code-landmarks.md 标记关键代码位置;archive/ 在会话结束或大功能完成时归档冗长笔记。
检查点分三层:Tier 1 在完成小任务后约 30 秒更新当前状态;Tier 2 在完成特性、架构决策或约 20 次工具调用后做完整检查点并记决策;Tier 3 在会话结束、大里程碑或上下文过重(约 50+ 次调用)时归档并压缩活跃上下文。与待办联动时,完成一项 todo 会同步更新状态、决策与地标。通过 CLAUDE.md 引用会话规则,并在会话开始时先读 current-state.md 宣告「从何处恢复」。
适用边界与注意点
这是 开发会话内的状态管理约定,不是通用笔记系统。状态文件要保持可扫读,避免写成冗长叙事;不更新或从不归档会让 current-state.md 迅速失效。探索失败的路径、冗长调试栈应归档或只留结论,否则上下文仍然臃肿。用户可用「更新会话状态」「结束会话」「从上次会话恢复」等提示触发检查点或交接。
使用场景
- 跨天继续同一功能:离开前做 Tier 3 归档,回来先读 current-state 再接下一项改动
- 在长对话里每完成一个 todo 用 Tier 1 更新进度,避免只记得最后几句聊天
- 做完库或架构选型后立刻写入 decisions.md,方便下次争论同一问题时查依据
- 上下文接近上限时按 Tier 3 压缩:保留阻塞项与地标,把冗长调试笔记移入 archive
适合人员
- 用 Claude/Cursor 等 Agent 连续改多文件、会话动辄上百轮工具调用的全栈工程师
- 需要在多次中断后仍能对齐「当前任务与未决架构决策」的技术负责人或开源维护者
- 为团队编写 CLAUDE.md 与项目规范、希望 Agent 默认遵守会话交接流程的仓库治理者
- 单人维护大型仓库、经常在不同子系统间切换、容易忘掉代码入口位置的个人开发者