用途:这是 agent guardrails 的反馈闭环环节。先用 /agent-guardrails:install 安装规则,使用一段时间后运行 /agent-guardrails:update,重新分析会话日志以衡量规则效果并调优模式。
主要能力:读取已安装的 .claude/hooks/stop-guardrails.sh,解析每条 grep 规则(名称、模式、消息);读取插件 rules/ 目录下的规范规则定义(六类基线:no-guessing、no-stalling、no-preference-asking、no-false-completion、no-skipping、no-dismissing);扫描近期会话日志(默认最近 7 天,可用 $ARGUMENTS 指定范围),统计每条规则的匹配次数、匹配片段与高频触发短语,并做全量反模式扫描以发现未被规则覆盖的模式。
使用方式:运行 /agent-guardrails:update,可附带时间范围参数。分析脚本位于 /tmp/agent-guardrails-update.py,仅用 Python 标准库,需容忍格式错误的 JSONL、跳过 subagent 会话、支持 --days N。随后按四类状态评估规则:工作良好、过于激进(误报)、过于宽松(漏报)、无数据;输出更新报告,包含规则有效性表格、详细发现、未覆盖缺口与建议,最后用 Edit 工具修改 .claude/hooks/stop-guardrails.sh 应用变更并回读验证。
适用场景:需要持续调优 Claude Code 行为约束规则、减少误报漏报、补充新反模式规则时。
限制:若脚本不存在需先安装;无会话日志需先积累会话;规则安装不足 2 天时样本量小,结果可能不具代表性;用户自定义规则应基于其版本而非规范原版提出建议。具体收费、平台支持等信息暂未提供。