SuperAPI AI 工具集

freeze

编程与开发

查看项目

更新于 10-16 02:37

技能介绍

用途:在聚焦任务(调试、小范围重构、审查)中限制 Claude 可编辑的文件范围,或完全冻结编辑进入只读调查模式。

主要能力:编辑锁保存在项目内 .claude/.freeze 文件,每行一个项目相对路径前缀;空文件表示冻结全部编辑。由 freeze-gate.sh 这个 PreToolUse 钩子强制执行,白名单之外的 Edit/Write/NotebookEdit 会被拒绝并给出原因,提示 Claude 不要重试。没有哨兵文件时钩子处于休眠状态,不加锁。

使用方式:通过 /phx:freeze 命令调用。不带参数为冻结全部编辑(只读调查模式);/phx:freeze lib/app_web priv/repo 只允许编辑这些目录;/phx:freeze status 查看当前锁状态;/phx:freeze off 解除锁(删除哨兵文件)。底层用 Bash 管理哨兵,例如 mkdir -p .claude && : > .claude/.freeze 冻结全部,printf '%s\n' lib/app_web priv/repo > .claude/.freeze 限定目录,rm -f .claude/.freeze 解除。

适用场景:与 /phx:investigate(定位根因时冻结全部)和 /phx:work(按计划目录限定范围)配合使用。

限制:路径是项目相对前缀,lib/foo 允许 lib/foo 及其下所有内容,但不允许 lib/foobar。哨兵必须只用 Bash(:>、printf、rm)管理,不能用 Edit/Write,否则会被钩子拦截。锁会持续到执行 /phx:freeze off,包括后续会话,任务结束时应清除,不要跨无关任务保留。该锁是辅助性工具,不是安全边界,任何人都可运行 /phx:freeze off 解除。