开发与工程 ✓ Anthropic · 官方 hookify-rulesregex-patternsyaml-frontmatterbash-hooksfile-hookscompletion-checks

Hookify 规则编写助手

帮助你为 Claude Code 编写可警告或阻止操作的 Hookify 规则。

FollowSkills 评估 · FSRS-2.0
不推荐
45/ 100 五分制 2.3 / 5
信任安全13 / 25 · 2.6/5

技能明确说明规则位置、事件范围和 warn/block 行为,并提示敏感文件与危险命令;但没有要求用户确认、说明完整数据流、提供回滚方案或限制规则权限,且许可证与依赖安全信息不完整,因此扣分。

可靠稳定7 / 20 · 1.8/5

文件格式、字段、事件和工作流步骤基本自洽,且给出正则测试建议;但未提供失败输入、解析错误、匹配边界或运行时故障反馈,源文件也没有覆盖关键路径的测试,因此按静态评估限制不超过10分并扣分。

适用触发9 / 15 · 3.0/5

触发短语、事件类型、字段和操作符描述较清楚,适用于创建和维护 Hookify 规则;但非适用场景、语义触发边界和中文支持未说明,且建议使用在线正则测试器可能受中国大陆网络可达性影响,因此扣分。

规范维护7 / 15 · 2.3/5

文档有概览、格式说明、示例、工作流和快速参考,版本号也已声明;但缺少变更记录、维护责任与更新路径,选定技能自身没有明确许可证信息,且依赖和故障排查说明有限,因此扣分。

有效结果6 / 15 · 2.0/5

技能提供可直接复制的规则模板、事件映射、正则示例和命名约定,能够覆盖核心写规则任务;但没有静态可验证的实际输出或运行结果,模式正确性和兼容性仍需人工检查,因此未超过静态上限并扣分。

证据核验3 / 10 · 1.5/5

选定文件本身提供了可审计的语法、示例和步骤,README及工作流仅能提供有限仓库背景;没有提交的测试套件、第三方执行证据或多源交叉验证,因此仅给有限分数。

证据充分度: 评估于 2026年7月20日 审查版本 015170d3fd84
使用前请注意
  • 规则可执行阻断或停止行为,但文档未要求创建前确认,也未说明误匹配时的恢复或回滚流程。
  • 正则、事件字段和高级条件的实际兼容性未由提交测试证明;应在隔离项目中验证,并避免直接依赖在线测试服务。
  • LICENSE.md仅说明商业条款,未明确该技能的独立许可范围。
评估证据 [1][2][3][4][5][6][7]
查看完整评分方法 →

它能做什么 & 适用场景

该技能用于创建、配置和完善 Hookify 规则。规则以带 YAML frontmatter 的 Markdown 文件保存于项目的 `.claude/` 目录,可匹配 Bash 命令、文件编辑、停止事件或用户提示。它说明了简单正则规则和多条件规则的写法,并提供消息内容、文件命名和调试建议。技能面向 Claude Code 的 Hookify 机制,其他平台可能需要适配。

指导用户创建 .claude/hookify.{rule-name}.local.md 文件;设计 nameenabledeventactionpatternconditions 字段;为 Bash、文件、停止和提示事件编写正则或条件匹配;编写触发后显示的 Markdown 消息;建议使用 python3 测试正则;说明如何编辑、禁用或删除规则。

  1. 希望阻止 `rm -rf`、`sudo` 或高风险权限命令的 Claude Code 用户。
  2. 希望在编辑 TypeScript 文件时提醒 `console.log` 或 `eval` 的开发者。
  3. 需要在修改 `.env`、凭据或证书文件时显示安全提示的团队。
  4. 希望在 Claude Code 停止前检查测试、构建或文档状态的项目维护者。
  5. 需要根据用户提示内容触发部署检查清单的开发者。

优缺点一览

优点
  • 覆盖 Bash、文件、停止和提示四类事件。
  • 同时支持简单正则和多条件匹配。
  • 说明规则启用、禁用、警告和阻止行为。
  • 提供命名、消息编写和常见正则陷阱的具体建议。
局限
  • 依赖 Claude Code 的 Hookify 机制和 `.claude/` 规则文件约定。
  • 来源没有说明独立插件安装流程、平台兼容范围或测试套件。
  • 规则效果取决于正则或条件的准确性,技能没有提供自动验证工具。
  • `action` 的具体运行行为按事件类型区分,跨其他 Agent Skills 客户端不能直接假定可用。

如何安装

README 仅说明如何安装 Claude Code,例如在 macOS/Linux 执行 curl -fsSL https://claude.ai/install.sh | bash,然后进入项目目录运行 claude。该来源没有提供此技能或 Hookify 插件的独立安装命令;技能位于仓库的 plugins/hookify/skills/writing-rules/SKILL.md

如何使用

在 Claude Code 中使用自然语言触发,例如:create a hookify rule to warn about rm -rfwrite a hook rule for console.log in TypeScript filesconfigure hookify。随后按技能说明在项目根目录创建 .claude/hookify.{descriptive-name}.local.md,并在下一次工具使用时测试规则。

常见问题

这个技能本身会自动创建或执行规则吗?
来源内容将其定位为编写和配置指导;它说明应创建规则文件并测试下一次工具使用,但没有声明自身会自动执行这些操作。
规则可以阻止操作吗?
可以在 frontmatter 中设置 `action: block`;未填写时默认为 `warn`。阻止行为取决于事件类型。
使用这个技能需要网络吗?
来源没有显示运行规则需要网络。它仅提到可选的在线正则测试网站。
它适合哪些项目?
适合使用 Claude Code、希望对命令、文件修改、停止流程或用户提示设置提醒和阻止规则的项目。

同仓库的其他 Skills

均来自 anthropics/claude-code

相关 Skills