> 族内折叠指针(技能质量管理族 · 治理段)
> 本技能已归入 zfl-skill-governance(本段唯一入口)。日常使用请从主技能进入。
> 目录与脚本资产保留,供主技能及其他技能直接调用,请勿重复实现本技能已有能力。
约束与错误处理
- 本技能是硬门控:只做「快照 → 回归 → 接受/回滚」判定,不替用户改技能内容;回归标准件委托 zfl-contrastive-regression,两侧判据 SSOT 在
zfl-common/references/two-sided-eval.md,本目录不复制判定逻辑。 - 未知
--flag一律报错退出(exit 2),不静默忽略——声明过的选项必须有解析点。 - 错误处理:无基线文件时
check直接要求先snapshot;退出码语义固定(0 接受 / 1 拒绝回滚 / 3 No-op / 2 用法错误),调用方据此分支。
参考文档
zfl-common/references/two-sided-eval.md:两侧样本四象限判据 SSOT(Q1/Q2/Q3/Q4 定义、θ_bad 与 ε 标定)scripts/gate.py:本门控唯一实现(snapshot/check/restore/status 四个子命令,退出码 0/1/2/3)- 回归样本来源:zfl-contrastive-regression 的确定性用例集(本门控只消费其输出,不维护样本)
不适用场景
- 不适用于需要实时交互或外部 API 调用的场景。
- 不适用于超出本技能声明范围的任务类型。
输出与格式
- 输出格式:结构化文本,包含明确的章节划分与关键结论。
- 输出结构:按任务类型返回对应格式,确保可读性与可追溯性。
示例(改技能前拍快照、改完硬门控回归)
用户:「我要改 zfl-skill-x 的提示词,改完别让通过率掉」→ 本技能把「前向闭环验证」做成一行命令的硬门控:
1. 改前快照:gate.py snapshot <skill_dir> 在技能目录写 .gate_baseline.json,记录当前 SKILL.md/scripts 哈希与上次回归加权通过率。
2. 动手改:编辑 SKILL.md / scripts/(本门控不限制改什么,只负责改后判定)。
3. 改后重跑回归:gate.py check <skill_dir> 调 zfl-contrastive-regression 跑确定性样本;加权通过率不降且无新增 FAIL → 接受(exit 0)并刷新基线。
4. 退化判定:通过率下降或出现新 FAIL → 自动回滚到快照(exit 1);加 --no-rollback 则只报告不回滚。
5. 两侧四象限:harness 输出 [SIDES] 行时自动升级为两侧样本判定(Q1 接受 / Q2 拒绝回滚 / Q3 No-op / Q4 拒绝回滚),用 --eps-samples 容忍小样本池的零星波动。
实际命令形态(<skills_root> 为技能根目录占位符):
# 1) 改技能前拍快照,记录基线通过率到 .gate_baseline.json
python <skills_root>/zfl-skill-edit-gate/scripts/gate.py snapshot "<skills_root>/zfl-skill-x"
# 2) 改完后重跑回归——加权通过率不降才接受,否则自动回滚
python <skills_root>/zfl-skill-edit-gate/scripts/gate.py check "<skills_root>/zfl-skill-x"
# 3) 只想看当前基线、不动手
python <skills_root>/zfl-skill-edit-gate/scripts/gate.py status "<skills_root>/zfl-skill-x"