Hookify 规则编写助手
帮助你为 Claude Code 编写可警告或阻止操作的 Hookify 规则。
技能明确说明规则位置、事件范围和 warn/block 行为,并提示敏感文件与危险命令;但没有要求用户确认、说明完整数据流、提供回滚方案或限制规则权限,且许可证与依赖安全信息不完整,因此扣分。
文件格式、字段、事件和工作流步骤基本自洽,且给出正则测试建议;但未提供失败输入、解析错误、匹配边界或运行时故障反馈,源文件也没有覆盖关键路径的测试,因此按静态评估限制不超过10分并扣分。
触发短语、事件类型、字段和操作符描述较清楚,适用于创建和维护 Hookify 规则;但非适用场景、语义触发边界和中文支持未说明,且建议使用在线正则测试器可能受中国大陆网络可达性影响,因此扣分。
文档有概览、格式说明、示例、工作流和快速参考,版本号也已声明;但缺少变更记录、维护责任与更新路径,选定技能自身没有明确许可证信息,且依赖和故障排查说明有限,因此扣分。
技能提供可直接复制的规则模板、事件映射、正则示例和命名约定,能够覆盖核心写规则任务;但没有静态可验证的实际输出或运行结果,模式正确性和兼容性仍需人工检查,因此未超过静态上限并扣分。
选定文件本身提供了可审计的语法、示例和步骤,README及工作流仅能提供有限仓库背景;没有提交的测试套件、第三方执行证据或多源交叉验证,因此仅给有限分数。
- 规则可执行阻断或停止行为,但文档未要求创建前确认,也未说明误匹配时的恢复或回滚流程。
- 正则、事件字段和高级条件的实际兼容性未由提交测试证明;应在隔离项目中验证,并避免直接依赖在线测试服务。
- LICENSE.md仅说明商业条款,未明确该技能的独立许可范围。
它能做什么 & 适用场景
该技能用于创建、配置和完善 Hookify 规则。规则以带 YAML frontmatter 的 Markdown 文件保存于项目的 `.claude/` 目录,可匹配 Bash 命令、文件编辑、停止事件或用户提示。它说明了简单正则规则和多条件规则的写法,并提供消息内容、文件命名和调试建议。技能面向 Claude Code 的 Hookify 机制,其他平台可能需要适配。
指导用户创建 .claude/hookify.{rule-name}.local.md 文件;设计 name、enabled、event、action、pattern 和 conditions 字段;为 Bash、文件、停止和提示事件编写正则或条件匹配;编写触发后显示的 Markdown 消息;建议使用 python3 测试正则;说明如何编辑、禁用或删除规则。
- 希望阻止 `rm -rf`、`sudo` 或高风险权限命令的 Claude Code 用户。
- 希望在编辑 TypeScript 文件时提醒 `console.log` 或 `eval` 的开发者。
- 需要在修改 `.env`、凭据或证书文件时显示安全提示的团队。
- 希望在 Claude Code 停止前检查测试、构建或文档状态的项目维护者。
- 需要根据用户提示内容触发部署检查清单的开发者。
优缺点一览
- 覆盖 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 -rf、write a hook rule for console.log in TypeScript files 或 configure hookify。随后按技能说明在项目根目录创建 .claude/hookify.{descriptive-name}.local.md,并在下一次工具使用时测试规则。