用途:为 Python 仓库搭建面向编码代理的执行层护栏,包括 Claude Code hooks(给代理即时、确定性反馈,并硬拦截少数绝不允许的操作)、设置接线、简短规则文件与经审查的公开技能。适用对象是使用 Claude Code 等编码代理的 Python 项目。
主要能力:提供三层配合的检查体系——规则文件(AGENTS.md,读取于会话开始,可被遗忘)、Claude Code hooks(在每次代理动作时运行,可在文件落盘前预防)、pre-commit(提交时)、CI 与规则集(合并时,唯一真正不可绕过的门禁)。自带三个 stdlib Python hook 脚本:guard_bash.py 在 PreToolUse 拦截危险 bash(--no-verify、SKIP=、core.hooksPath 重定向、强推 main、裸 pip、宽范围 rm -rf);lint_edited_file.py 在 PostToolUse 对刚编辑的单个 Python 文件做 ruff 检查(只报告,不重写);stop_verify.py 作为 Stop 门禁,运行仓库自身的 pre-commit(对变更与未跟踪文件跑两次以让自动修复收敛),无 pre-commit 时回退到单个 VERIFY_CMD。另有 scripts/check_guardrails.py 只读审计设置、hook、匹配器与规则文件。
使用方式:先运行 python3 "${CLAUDE_SKILL_DIR}/scripts/check_guardrails.py" --root . 审计现状;编辑根目录 AGENTS.md 并由 CLAUDE.md 以 @AGENTS.md 导入;将 hook 脚本复制到 .claude/hooks/ 并加可执行权限;把设置模板接入 .claude/settings.json;用 stdin 实测每个 hook 的退出码(exit 2 才是阻塞);最后在真实会话中触发每个护栏。安装前需审查第三方技能与插件,建议预构建 hook 环境(uv run pre-commit install --install-hooks)。
限制:hook 是本地的、用户可编辑的,不是安全边界,CI 与服务器端规则才具权威性;匹配器区分大小写,Edit|Write|NotebookEdit 覆盖不到 shell 写文件;Stop hook 必须处理 stop_hook_active 以免循环;hook 行为存在版本漂移,应以官方 hooks 文档为准。Pydantic/Instructor 等运行时数据校验、CI 工作流、git 提交钩子、ruff/类型/测试配置本身不在本技能范围内。具体收费、价格与平台支持资料暂未提供。