用途
guard(/guard)被定义为“完整安全模式”(Full Safety Mode)。它把 /careful 与 /freeze 两项能力合并成一条命令:同时激活破坏性命令警告与按目录限定的编辑限制,用于在会话中为代码与文件操作加装双重保险。
主要能力
guard 启用后运行两重保护:
- 破坏性命令警告:rm -rf、DROP TABLE、force-push 等操作会在执行前给出警告,用户可以选择覆盖(override)后继续执行。
- 编辑边界:文件编辑被限制在指定的
<path>/之内,超出该目录的编辑会被阻止(blocked)。
关于破坏性命令的完整模式清单与安全例外,资料指向 /careful;关于编辑边界的具体执行机制,资料指向 /freeze。
使用方式
设置阶段,技能会通过 AskUserQuestion 询问用户要限制编辑的目录:
- 提问内容:Guard mode: which directory should edits be restricted to? Destructive command warnings are always on. Files outside the chosen path will be blocked from editing.
- 采用文本输入(非多选题),由用户输入一个路径。
用户给出目录路径后,依次执行:
- 解析为绝对路径:
FREEZE_DIR=$(cd "<user-provided-path>" 2>/dev/null && pwd)
echo "$FREEZE_DIR"
- 确保结尾斜杠并保存到 freeze 状态文件:
FREEZE_DIR="${FREEZE_DIR%/}/"
STATE_DIR="${CLAUDE_PLUGIN_DATA:-$HOME/.gstack}"
mkdir -p "$STATE_DIR"
echo "$FREEZE_DIR" > "$STATE_DIR/freeze-dir.txt"
echo "Freeze boundary set: $FREEZE_DIR"
设置完成后,技能会告知用户:
- Guard mode active. Two protections are now running.
-
- Destructive command warnings — rm -rf、DROP TABLE、force-push 等会在执行前警告(可覆盖)。
-
- Edit boundary — 文件编辑被限制在
<path>/之内,目录之外的编辑被阻止。
- Edit boundary — 文件编辑被限制在
- 要移除编辑边界,运行 /unfreeze;要停用全部保护,结束会话。
依赖说明
guard 引用了同级 /careful 与 /freeze 技能目录中的钩子脚本(hook scripts)。两者都必须已安装,它们由 gstack 安装脚本一并安装。
此外,资料中还包含一段使用统计记录命令:
mkdir -p ~/.gstack/analytics
echo '{"skill":"guard","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}' >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
适用场景
适用于需要在会话中获得双重安全约束的操作环境:既希望对高风险破坏性命令保持事前提示,又希望把文件改动范围锁定在指定目录内,避免越界修改。
限制
- 依赖 /careful 与 /freeze 两个同级技能及其钩子脚本,二者必须已安装。
- 编辑边界之外的文件编辑会被阻止;破坏性命令警告可由用户覆盖。
- 其他细节(如支持平台、收费情况、版本要求等)暂未提供。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- garrytan/gstack/guard/SKILL.md — 署名:Garry Tan;许可:MIT;版本:
f4bbfaa5bdfd2d6ce59541c2145432febde57fed。