技能介绍

核心问题

在规范驱动的开发流程中，版本边界管理常陷入三大困境：手工复制快照易引入不一致，字段契约校验遗漏导致规格漂移，冻结阶段缺失关键门禁让未达标版本流入正式环节，最终打乱后续开发节奏。

工作机制

该技能专注于版本边界的确定性操作，模型仅负责确认版本意图并读取脚本生成的紧凑结果，无需重复解释完整契约。工作区扫描、校验和快照构建全部由确定性脚本完成，从根源避免手工操作误差。

双模式边界管理

支持两种标准化操作：

freeze：将草稿转为冻结版，自动生成带日期的规范快照目录，同步产出manifest、CHANGELOG和SPEC-INDEX
begin-revision：基于上一冻结快照开启更高版本的修订草稿，历史快照全程不可修改

冻结前置校验

字段密集型规格冻结前，必须通过字段契约校验，并将field-contract.json、field-coverage.json等关键文件纳入快照。冻结时需满足四大条件：正式评审有效、风险override记录完整、闭环矩阵等文档与当前规格一致、关键过渡节点均有证据支撑，缺失任一条件都会阻断冻结流程。

适用边界

该技能中的版本参数对应规格修订版，而非产品版本，产品版本需从当前草稿读取并写入快照清单，禁止直接用Git顶层目录作为版本标识。冻结失败时会保留原文件，不覆盖历史快照，也不会触发发布操作。工作区治理钩子仅处理临时残留，未知或错位文件需人工处理后重试，禁止通过/archive/目录归档历史迭代版本。