freeze 是一个把仓库之外的状态冻结为单一快照的技能,适用于工作依赖某个服务、数据库、队列、第三方或实时日志当前状态的场景。
用途:在动手之前,先确定工作到底依赖哪些外部事实,并以只读方式取得这些事实的实时值,形成一份可核对、可锁定的快照,避免把猜测当作依据。
主要能力与流程:
- 界定范围:判断这项工作触及哪些外部事实;若同一问题有两种读法且会构建出不同快照,使用 clarify 技能澄清,范围限定在工作触及的切片,而非绘制全局地图。
- 命名事实:列出工作所依赖的事实名称;命名哪些事实重要是唯一需要推理补足的地方,每项事实的值均来自实际读取。
- 只读读取:对每项命名事实进行实时、只读读取——只看不改:不写入、不调用会改变状态的接口、不切换开关。无法读取、或读取本身会改变事实的,记为开放缺口,并附上供人工手动获取的说明。
- 整理快照:使用 draft 技能整理快照,将已观察事实与开放缺口分开;每项已观察事实注明其内容、所在位置和读取时间;任何基于事实得出的结论须标记为结论,并排除在已观察事实集合之外。
- 校验:使用 judge 技能校验主张——每项命名事实要么已被观察,要么是明确的开放缺口,且没有编造任何值;编造的值降级为缺口或重新观察。
- 迭代:人工获取的事实、重新观察或修订会重新进入快照,快照再次接受校验。事实的值要么是观察到的,要么是缺口,不存在第三种。
使用方式:快照在对话中呈现,无状态保存;重新运行整个冻结流程即可刷新。交付形式为两份简短项目符号列表:每项已观察事实一行,注明所在位置和读取时间;每个缺口一行,明确标注为缺口。当 judge 的结论成立且用户锁定,或用户在缺口仍然存在时停止,快照即告成立;带有明确开放缺口的快照是有效的锁定,缺口即为其开放部分。
适用场景:工作依赖于外部服务、数据库、队列、第三方系统或实时日志的当前状态时。
限制与例外:若所有所需事实都位于仓库内,则在工作运行处直接读取,不生成快照;若外部系统本身就是要被修改的对象而非读取依据,那属于工作本身,直接推进工作即可。