技能介绍

你真正缺的是边界，不是更「聪明」的模型

修一个小 Bug，Agent 顺手重构整仓；迭代几轮后主题跑偏，你说停的时候无关文件已经改了一大片；测试失败后它自作主张回滚，把本不该动的版本也覆盖掉。这类问题很少是模型「不懂代码」，而是协作没有可执行的 scope：开工前没对齐「动什么、不动什么」，执行中也没有在破坏性操作前硬停。

Scope Guard 怎么约束一次任务

在对话开头说 🔒 範圍守衛 on（或简体语境下同等口令）即可启用。技能会在开工前推断任务边界，你有异议可以直接纠正，避免悄悄扩 scope。

核心行为可以概括成几条硬规则：

自停：准备删文件、覆盖未备份原件、或「顺手」改无关模块时会停下，等你确认。
按需备份：覆盖前做快照，只备份与任务相关的文件；大文件可只存差异，减少占用。
回滚带上下文：回滚时会提醒「本任务还改了 B、C，是否一并回滚」，降低部分回滚造成的不一致。
测试失败不擅自收尾：代码完成后可自动跑测试；失败时停在失败态，不自动回滚、不自动修复，等你的指令。
侧向问题只标记：发现新问题只记入清单、不打断主线；对话结束后可一次性导出。
紧急模式：说 🔒 緊急 时绕过确认流程全力修补，事后补报告。

版本策略上默认保留 3 层：PRE（任务前原版，长期保留）、BAK（覆盖前安全版，可回滚）、MID（迭代检查点，完成后收敛）；复杂任务可说「多留几版」，最多扩到 5 版。

常用口令包括：只修這個（锁死范围）、回滾、看側向清單、看備份、停（立即停止并导出当前状态）；需要发散时用 🔓 守衛 off。

适用边界与注意点

它解决的是单次对话/任务内的范围与备份，不是替代 Git 工作流或 CI。生产紧急修复适合 🔒 緊急；头脑风暴、创意探索应关闭守衛。使用统计写入本地 ~/.qclaw/skills/scope-guard/usage.json，只记维度、不上传；可说「清理统计」清空。本技能由 OpenClaw 用户社群共创，仍在迭代中。