agentleFS
Sign inStart free
SnowyLakeSnowyLake/SnowySkills/checkpoint-save/SKILL.md

checkpoint-save

Skill4 starsChanged 23 days agoMITView on GitHub

Save or refresh the current session's context and history for later reading, continuation, or review.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 1

    1. SnowyLake/snowy-agent-skills★ 4100% same

    Edited · 0

    None found.

    Wrote their own version · 0

    None found.

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository6 other files it gives its agents.

The file

Create a free account to mount
Files
SKILL.md

checkpoint-save

目录

  • 目标与边界
  • 会话文件夹解析
  • 保存
  • 完成

目标与边界

保存供后续读取, 续接或审查的当前状态和必要历史. 本 skill 只写当前会话文件夹中的 CONTEXT.md 和 HISTORY.md; 不修改项目文件或其他产物, 除非用户另有明确要求.

保存前读取 checkpoint-contract.md 中的共享规则和文件结构. 若文件不可用, 停止并报告缺失文件, 不凭记忆重建契约.

会话文件夹解析

读取其他会话的 checkpoint 不会将其来源文件夹设为当前会话文件夹. 仅作为读取来源的路径不作为保存位置的候选; 用户明确指定共享文件夹作为当前会话文件夹时, 才按该指定保存.

将当前会话文件夹解析为三种状态:

  • 明确有: 当前对话或用户输入已经明确指向一个当前会话文件夹. 复用它.
  • 明确没有: 当前对话没有可用会话文件夹线索, 且用户请求是在创建或刷新当前 checkpoint. 创建新的当前会话文件夹.
  • 不确定: 现有线索无法识别唯一当前会话文件夹, 或用户同时提到多个路径但没有标明角色. 询问用户指定已有文件夹或确认创建新文件夹.

创建新文件夹时, 使用 .agent-sessions/{YYYYMMDD}-{short-kebab-case-session-summary}/, 并在输出中说明新建路径.

保存

  • 先读已有 CONTEXT.md, 结合当前对话和影响本次保存的项目事实确定变化. 对已有 HISTORY.md, 先查最近相关条目, 需要追溯时再扩大阅读, 不要求每次通读全部历史.
  • 优先保存后续 agent 无法从项目文件直接恢复, 或重新获取成本较高的信息: 用户目标和范围, 重要决策及理由, 未完成工作的准确位置, 已做验证及其范围, 未验证假设. 可从代码直接获取的细节保留必要说明和文件引用即可.
  • 将 CONTEXT.md 维护为干净的当前快照, 同步 Work Artifacts; 没有工作产物时该章节可以为空. 将仍有价值的过期过程记录, 已拒绝方案和被取代的决策依据移入历史.
  • 首次保存时建立两个文件. 后续仅在状态有实质变化或出现值得保留的新背景时, 向 HISTORY.md 追加一个新条目, 不合并进旧条目. 两个文件完整且没有实质变化时, 保持文件不变, 不追加重复历史.
  • 保留已有历史条目, 包括未读取的部分; 未经用户要求不清理或重建旧历史. 缺少文件时补齐可确认的内容并说明缺失, 不虚构已丢失的信息. 写入时遵守契约中的文件结构并同步 TOC.

完成

确认需要保存的状态和历史已写入, 文件结构及引用与本次变化一致. 若只完成部分写入, 如实说明, 不报告全部保存成功.

简要报告会话路径, 已更新文件, 关键变化和仍影响续接的未解决事项. 无实质变化时说明 checkpoint 已是最新. 默认不逐段复述快照; 用户要求完整状态时再展开.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free