智能检查点触发

概述

智能检查点触发是基于语义事件（而非固定时间间隔）自动创建检查点的机制，确保在关键开发节点持久化状态和决策历史。

关键内容

1. 触发事件类型：五类语义事件触发检查点——feature_complete（完成完整功能）、tests_pass（测试套件通过）、breaking_change（引入破坏性变更）、architecture_decision（做出重要架构决策）、context_threshold（上下文窗口 > 70%）。

2. 与固定间隔的对比：传统检查点按固定时间间隔触发，可能在不重要的中间状态浪费资源，或在重要决策点遗漏保存。智能检查点只在语义上有意义的时刻触发，效率更高。

3. 上下文阈值触发：当上下文窗口使用超过 70% 时自动触发检查点，这是防止上下文溢出的安全机制。触发后 Harness 可以压缩上下文、外化状态到文件，或启动新会话。

4. 与 特性追踪器 的联动：当特性追踪器中某个功能的状态从 in_progress 变为 complete 时，自动触发 feature_complete 检查点，记录该功能的完整开发历史。

5. 检查点内容：每个检查点包含当前代码状态、特性追踪器 快照、上下文传递协议 包、已知问题列表和 技术债务追踪 日志。检查点 ≈ CI 构建，是 Harness 与 CI/CD 类比的核心对应点。

来源

• 14_harness_design_long_running.md — 第二节"核心 Harness 组件"，智能检查点触发章节

相关

• Harness 设计 — part_of (是 Harness 的核心组件)
• 特性追踪器 — relates_to (特性完成时触发检查点)
• 上下文传递协议 — relates_to (检查点包含上下文包)
• 技术债务追踪 — relates_to (检查点记录技术债务状态)