Synthesis Checkpoint 是一个用于重新同步 AI 会话与项目实际状态的技能，旨在解决模型与磁盘实际内容之间的偏差问题。随着时间推移、其他会话修改记录、上下文压缩丢失细节以及缓存事实老化，模型可能基于过时信息做出错误声明。该技能提供了一种简短的、可编码的、可见的重新同步过程，依据系统时钟、项目文件、git 历史和看板进行验证。
用途：该技能主要用于在以下触发条件下运行：状态请求或“继续”请求、暂停 10 分钟或更久、约 25 次工具调用后、出现“我不记得了”、发现意外文件、收到更正、新的看板消息或项目切换。它也可按需运行，或在漂移信号出现时运行。
主要能力：
- 绑定规则：在做出任何时间间隔声明、状态引用、会话日志条目或带日期的提交信息之前，先运行 date 命令并阅读记录；记录是缓存，git 和带日期的会话条目是证据；提交时间不定义工作日；匹配日期不能证明当前记录有效；只能使用当前会话自己的项目；在触发条件下运行；在下一个回复中展示验证信息（日期、最新会话及其来源、任何分歧、声明、下一步）；仅在声明下修正过时记录，被拒绝的声明报告为 id（项目 · 工具）；检查点不触发另一个检查点，重用已有证据后返回下一个交付物。
- 关闭前询问：哪些可执行状态或必需输入数据仍仅存在于当前会话的暂存区？如果持久记录引用了其输出，则在检查点关闭前将脚本和必需输入保存在 resources/scripts/ 下。
- 刷新并报告：只读操作，检查并报告，安装的文件不是重新加载的工具。
使用方式：该技能包含一个简短的程序（六个步骤），每次都应阅读。首次在会话中使用时或步骤不明确时，阅读 references/protocol.md 获取问题描述、所有触发条件、每个步骤的完整说明、输出示例、什么算实质性工作以及与其他技能的关系。当要求刷新后报告或生态系统变更后报告时，阅读 references/refresh-and-report.md 获取只读通过、重新加载证据和重启阶梯。references/coverage-map.md 说明 1.9.1 各部分现在的位置。references/preserved.md 包含被删除的内容及原因，以及 1.9.1 的原文。
程序步骤：
- 看板：使用 synthesis who 和 synthesis inbox 检查声明是否正确、是否有消息、是否有其他人在场。
- 时钟：运行 date "+%Y-%m-%d %H:%M:%S %Z (%A)"，注意与您认为的时间的任何偏差。
- 项目：运行 synthesis brief（指令、当前状态、计划），然后阅读 CONTEXT.md、计划、最新的会话条目和 REFERENCE.md。在新会话中使用 synthesis resume <id>；CONFLICT 警告会停止项目写入。
- 证据：运行 git log -10 --pretty=format:"%h %ai %ci %s" -- <project> 和 git status --short -- <project>；比较带日期的会话条目与头部和索引。可选运行 python3 <synthesis-context-lifecycle>/scripts/context_doctor.py --project <path>。
- 决策：重新阅读计划和会话内任务列表；检查下一步所依赖的事实、原因和条件是否在记录中。
- 报告：输出一个简短段落，例如：Checkpoint complete. Today 2026-05-27 10:49 EDT (Wednesday). Latest recorded session 2026-05-25 (sessions/2026-05.md); last commit 2026-05-26 is publication evidence. CONTEXT.md and the index agree. Claim: <paths>, no conflict. Proceeding with [next action].
对于恢复、实质性漂移和显式刷新，使用完整协议。在已验证项目的连续工作中，仅检查下一个声明或变更所需的实时事实；新的矛盾会触发完整恢复。
适用场景：适用于需要长期维护项目上下文一致性的 AI 辅助开发场景，如状态汇报、继续工作、暂停后恢复、发现异常文件或看板消息、项目切换等。
限制：该技能要求用户具备 synthesis 工具链和 git 环境；部分步骤依赖特定命令和文件结构（如 CONTEXT.md、REFERENCE.md、sessions/ 目录等），这些文件需要按约定存在。该技能不提供自动修复功能，修正需在声明下进行。不保证在所有环境中可用，具体依赖未在资料中详细说明。