checkpoint

checkpoint

lets-work 的写入版对应工具。记录本次会话带给用户的认知，并尽可能将每项内容提升到更高层级：优先写入代码，其次写入仓库工件，最后才写入个人存储。

个人状态（零痕迹约定）

与 lets-work 遵循相同约定——两者必须保持一致：

• 根目录：${XDG_DATA_HOME:-$HOME/.local/share}/identity16-skills/projects/<repo-id>/
• repo-id：规范化后的 origin URL slug（移除协议、凭据和 .git；将 / 和 : 替换为 __）；没有远程仓库时，使用按相同方式处理的绝对路径 slug。
• 文件：state.json（上次访问标记）、dossier.md（心智模型；备用信息，绝不作为镜像）、journal.md（仅追加的会话日志）。

绝不要将上述任何内容，或对本技能包的任何引用，写入目标项目的文件、提交、PR 或议题。

仪式的分量必须与本次会话带来的认知相称。 如果常规会话没有产生值得保留的内容，就不必访谈：更新 state.json，用一行确认，完成。只有真正改变了用户理解的会话，才使用下面的完整路由流程。

步骤

1. 收集候选项：回顾整个会话，列出学到的内容——做出的决定、遇到的陷阱、发现的不变量、被证伪的假设、仍待解决的问题、WIP 状态。
2. 将每项内容沿层级向上路由，先提出晋升建议，不要悄悄直接应用：
   • 代码：代码无法表达的非显而易见约束或“原因” → 建议在关键位置添加简洁注释，并遵循目标项目的注释规范。
   • 仓库工件：采用当前方案的理由、被否决的替代方案 → 建议将其补充到 PR 描述或即将提交的提交消息中。
   • 个人日志：项目流程相关事实（讨论发生在哪里、如何在本地运行）、用户尚未解决的问题、WIP 备注——任何在仓库中无处可写的内容 → 按今天的日期追加到 journal.md。
3. 更新 dossier.md，记录心智模型的变化：新增或变更的不变量、得到纠正的看法。删除代码库现在已能清楚说明的条目——dossier 变短，说明代码库正在改善。
4. 使用当前提交、日期和分支写入 state.json。
5. 向用户确认各项内容写入了何处。

防护原则

• 晋升到仓库中的内容属于正常工作成果（注释、PR 文本、提交消息），但绝不能提及本技能包、个人存储或其路径。
• 不要将仓库中已有记录的内容写入日志（代码结构、Git 历史、现有文档）。