Navigator Compact Skill 是 qf-studio/navigator 提供的上下文管理技能，核心用途是在清空对话上下文之前，把当前工作状态保存为上下文标记（context marker），类似切换分支前先做一次 git commit，以便之后恢复。
主要能力：检测项目是否安装 PreCompact 钩子（版本 v6.10.0+）；若已安装，用户运行 /compact 或 Claude Code 自动压缩时，钩子会自动写入标记，文件名带 -auto- 标记，PostCompact 钩子会把官方摘要追加到标记中；若未安装，则按传统流程手动创建标记。创建标记时会捕获最近 10–15 条消息摘要、修改的文件、技术决策、当前进度和下一步。随后把标记文件名写入 .agent/.context-markers/.active，供下次会话的 nav-start 检测并提示恢复。
使用方式：当用户说出“clear context”“start fresh”“reset conversation”“done with this task”“approaching token limit”“compact”等表达，或完成独立子任务后触发。执行时先检查钩子；有钩子则只打印提示，让用户运行 /compact；无钩子则先评估对话消息数（少于 20 条建议等待，20–50 条可压缩，超过 50 条强烈推荐），再调用 nav-marker 技能创建名为 before-compact-{YYYY-MM-DD}-{HHmm} 的标记，写入 .active，展示清空对话的方法（新建会话或 /clear），最后用 ls 命令确认标记文件位置与大小。脚本 compact.py 可自动化该流程。
适用场景：完成某个功能或子任务后切换到下一任务、接近 token 上限时释放上下文、在多任务之间切换、长时间任务在逻辑断点处整理、多天任务在每次会话结束时保存进度。
限制与注意事项：Claude Code 不允许在对话内以编程方式清空会话，实际清空必须由用户新建会话或使用 /clear 命令；不建议在实现中途或下一步仍需当前上下文时调用，也不建议在对话少于 20 条时频繁压缩。若标记创建失败，应先修复再压缩；若已存在未恢复的 .active 标记，需先选择加载、覆盖或取消。