检查点管理(Checkpoint Management)
概述
检查点管理是一种在开发工作流中创建、验证和追踪进度快照的纪律性技能。通过 /checkpoint 命令,在关键节点创建带名称的检查点,后续可对比验证开发进展(文件变更、测试通过率、覆盖率等),确保复杂功能开发过程可控、可回溯。
典型工作流
[开始] --> /checkpoint create "feature-start"
|
[实现] --> /checkpoint create "core-done"
|
[测试] --> /checkpoint verify "core-done"
|
[重构] --> /checkpoint create "refactor-done"
|
[提交 PR] --> /checkpoint verify "feature-start"
工作流说明
- 功能开发开始时 — 创建起始检查点
feature-start,记录干净的初始状态 - 核心功能完成时 — 创建中间检查点
core-done,标记里程碑 - 测试阶段 — 验证
core-done检查点,确认核心功能实现后的测试状态 - 重构完成后 — 创建检查点
refactor-done,确保重构没有引入回归 - 准备提交 PR 时 — 验证
feature-start检查点,全面对比整个功能开发周期的变更
命令参数
| 参数 | 说明 |
|---|---|
create <name> |
创建命名检查点 |
verify <name> |
对比验证指定检查点 |
list |
显示所有检查点 |
clear |
移除旧检查点(保留最近 5 个) |
最佳实践
- 在每个重要里程碑创建检查点 — 而非在每个小改动后创建
- 使用有意义的检查点名称 — 如
auth-backend-done、db-migration-applied - 在重构前后各创建检查点 — 方便验证重构未引入回归
- 提交 PR 前验证初始检查点 — 全面审视整个功能的变更范围
- 定期清理旧检查点 — 使用
clear保持日志整洁