SuperAPI AI 工具集

guard

编程与开发

查看项目

更新于 10-16 23:14

技能介绍

用途

guard(/guard)被定义为“完整安全模式”(Full Safety Mode)。它把 /careful 与 /freeze 两项能力合并成一条命令:同时激活破坏性命令警告与按目录限定的编辑限制,用于在会话中为代码与文件操作加装双重保险。

主要能力

guard 启用后运行两重保护:

  1. 破坏性命令警告:rm -rf、DROP TABLE、force-push 等操作会在执行前给出警告,用户可以选择覆盖(override)后继续执行。
  2. 编辑边界:文件编辑被限制在指定的 <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.
  • 采用文本输入(非多选题),由用户输入一个路径。

用户给出目录路径后,依次执行:

  1. 解析为绝对路径:
FREEZE_DIR=$(cd "<user-provided-path>" 2>/dev/null && pwd)
echo "$FREEZE_DIR"
  1. 确保结尾斜杠并保存到 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.
    1. Destructive command warnings — rm -rf、DROP TABLE、force-push 等会在执行前警告(可覆盖)。
    1. Edit boundary — 文件编辑被限制在 <path>/ 之内,目录之外的编辑被阻止。
  • 要移除编辑边界,运行 /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 两个同级技能及其钩子脚本,二者必须已安装。
  • 编辑边界之外的文件编辑会被阻止;破坏性命令警告可由用户覆盖。
  • 其他细节(如支持平台、收费情况、版本要求等)暂未提供。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明