ECC Hookify 规则交互式配置指南用/hookify-configure动态启停行为防护规则【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC导读本文围绕 ECCThe agent harness performance optimization system中 Hookify 规则体系的运维与配置展开核心讲解/hookify-configure命令如何在不删除规则文件的前提下交互式地启用或禁用现有.claude/hookify.*.local.md规则并顺带梳理 Hookify 从创建/hookify、查看/hookify-list到切换/hookify-configure与帮助/hookify-help的完整管理闭环。读完本文你将掌握 hookify 规则文件的前置元数据frontmatter结构、事件类型与动作语义能够熟练对单条或多条规则进行批量启停并了解如何在 Claude Code 的 hook 体系中让规则随时可切换、永不丢失。一、Hookify 规则体系速览为什么需要配置环节Hookify 是 ECC 提供的一套行为防护机制它通过生成携带 YAML frontmatter 的 Markdown 规则文件接入 Claude Code 的 hook 系统在bash、file、stop、prompt等事件触发时用自定义消息对 Agent 进行警告warn或阻止block从而预防对话分析或显式指令中暴露出的不良行为。规则文件统一存放在项目根目录的.claude/下命名规范为.claude/hookify.{name}.local.md详见 hookify 命令文档 与 hookify-rules 技能。正因为规则会随项目演进不断积累用户需要一套低成本的状态管理手段——这正是/hookify-configure的定位它只修改规则文件 frontmatter 中的enabled:字段达到开关而不删除的效果让规则可以随时保留、随时恢复。在 ECC 的命令注册表中该命令被归类为系统级System命令与hookify、hookify-list、hookify-help共同构成 Hookify 子系统见 COMMAND-REGISTRY.json。二、/hookify-configure交互式启停的完整流程根据 commands/hookify-configure.md该命令的执行流程分为六个明确步骤整个过程中 Agent 与用户保持交互发现规则文件查找项目根目录下所有.claude/hookify.*.local.md文件。文件名的*部分即规则名例如hookify.warn-debug-code.local.md对应规则warn-debug-code。读取当前状态解析每个文件的 frontmatter重点读取enabled:字段的当前值true或false同时可读取name、event、action、pattern等字段用于展示。呈现规则清单将规则以带状态的列表形式呈现给用户标明每条规则当前是启用enabled还是禁用disabled。确认切换目标询问用户希望切换toggle哪些规则支持选择单条或按名称批量指定。更新启用字段在所选规则文件中修改enabled:字段——原值为true的改为false原值为false的改为true完成启停切换。确认更改结果向用户确认哪些规则已被切换以及当前生效状态。从流程可以看出/hookify-configure的核心价值在于幂等且可逆它不新增、不删除规则只翻转开关因此误操作可以随时再切回来非常适合在某类防护暂时影响效率但未来仍需要的场景下临时关闭。三、规则文件格式与enabled字段的底层语义要正确理解配置命令的行为必须先读懂规则文件本身。Hookify 规则是YAML frontmatter Markdown 正文的复合结构正文内容为规则触发时展示给 Claude 的消息支持多行与 Markdown 格式化--- name: rule-name enabled: true event: bash|file|stop|prompt|all action: block|warn pattern: regex pattern --- Message shown when rule triggers.各 frontmatter 字段说明如下依据 hookify-rules 技能 整理字段必填取值说明name是kebab-case 字符串规则唯一标识建议动词开头warn-*、block-*、require-*enabled是true/false启停开关/hookify-configure只修改此字段event是bash/file/stop/prompt/all触发该规则的 hook 事件类型action否warn/blockwarn默认仅展示消息block阻止操作执行pattern是*正则字符串匹配模式复杂规则可用conditions替代enabled字段的存在使规则以声明式状态存在关闭规则不需要删除文件或注释代码只需将其置为false规则即可从生效集合中退出同时保留全部配置便于日后恢复。这即是 hookify.md 中所说与/hookify-list和/hookify-configure配合管理规则的落点。四、事件类型与动作语义配置前必知的基础知识在进行规则启停决策时需要理解不同事件与动作的组合效果才能在配置时准确判断该关哪条、该留哪条。依据 hookify-help.mdbash在 Bash 工具调用时触发pattern 匹配完整命令字符串。典型场景拦截危险命令rm\s-rf、提权操作sudo\s、权限问题chmod\s777。file在 Write/Edit 工具调用时触发pattern 匹配文件路径或内容。典型场景拦截调试代码console\.log\(、debugger拦截安全风险eval\(、innerHTML\s*关注敏感文件\.env$、\.pem$。stop在会话结束时触发用于完成度检查与提醒pattern.*表示始终匹配。prompt在用户消息提交时触发pattern 匹配用户输入用于强制工作流。all在所有事件上触发。动作方面warn只展示提示消息而不打断操作适合高频、低风险的提醒block则直接阻止对应操作适合必须拦截的硬性防护。在/hookify-configure中当发现某条block规则误伤正常操作时优先考虑临时禁用该规则切换到enabled: false比删除文件更安全。五、Hookify 规则管理的完整闭环创建、查看、配置、帮助/hookify-configure并非孤立命令它是 Hookify 治理链路的一环。四个命令各司其职命令职责关键行为/hookify [描述]创建新规则无参数时调用conversation-analyzer分析当前对话挖掘显式纠正、对重复错误的挫败反应、被回退的改动、反复出现的相似问题生成规则文件/hookify-list列出所有规则读取每个文件的name、enabled、event、action、pattern以表格呈现并显示规则总数/hookify-configure交互式启停规则展示当前状态 → 询问切换目标 → 更新enabled字段 → 确认结果/hookify-help查看完整文档输出事件类型、规则格式、命令说明与 pattern 编写建议创建时生成的规则默认enabled: true见 hookify.md 的模板之后用/hookify-list查看全量状态与规则数量并在文末提示可用/hookify-configure随时变更状态见 hookify-list.md需要调整时再用/hookify-configure完成切换。这一闭环保证了规则从诞生、运行到停用的全生命周期可观测、可管理。六、结合源码与仓库的纵深理解命令注册与归类在 docs/COMMAND-REGISTRY.json 中hookify-configure的注册描述为 Enable or disable hookify rules interactively与hookify、hookify-list、hookify-help一并登记佐证了四个命令属于同一功能族ECC 的仪表盘脚本也将hookify前缀映射到 System系统类目见 scripts/dashboard-web.js说明该子系统在 ECC 命令体系中被视为基础设施级能力。技能层的一致性保障编写规则的完整规范沉淀在 skills/hookify-rules/SKILL.md 中其中除pattern单条件外还支持conditions多条件组合如field: file_pathoperator: regex_matchpattern: \.env$与field: new_textoperator: containspattern: API_KEY同时命中才触发字段可用性按事件区分bash:commandfile:file_path/new_text/old_text/contentprompt:user_prompt操作符包括regex_match、contains、equals、not_contains、starts_with、ends_with。无论规则多么复杂/hookify-configure都只操作最外层的enabled开关与规则内部结构解耦因此对复杂规则同样适用。七、实战要点与注意事项规则文件位置.claude/位于项目根目录命名必须遵循hookify.{name}.local.md否则无法被三个命令发现。版本管理与隐私建议将.claude/*.local.md加入.gitignore见 hookify-rules 技能 的文件组织说明规则属于个人/项目本地配置不应混入公共仓库。pattern 编写避坑避免过宽匹配如log会误中 login、dialog应写console\.log\(避免过死匹配如rm -rf /tmp应放宽为rm\s-rfYAML 引号内使用正则时需注意转义如\\s。上线前自测可用 Python 快速验证正则是否按预期命中python3 -c import re; print(re.search(ryour_pattern, test text))启停语义/hookify-configure只翻转enabled字段不删除文件若规则长期不再需要应先用/hookify-list确认状态再决定是禁用还是清理文件。总结/hookify-configure是 Hookify 规则治理中运行时开关的关键一环它以 6 步交互流程完成规则发现、状态展示、目标确认与enabled字段更新配合/hookify创建、/hookify-list查看、/hookify-help文档让开发者能够以文件即配置、开关即管理的方式在 Claude Code 的 hook 体系上建立一套可审计、可回滚的行为防护层。理解其底层规则文件结构与事件/动作语义是高效使用该命令的前提——这也正是从会执行命令到会治理规则的进阶所在。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ECC Hookify 规则交互式配置指南：用 `/hookify-configure` 动态启停行为防护规则
ECC Hookify 规则交互式配置指南用/hookify-configure动态启停行为防护规则【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC导读本文围绕 ECCThe agent harness performance optimization system中 Hookify 规则体系的运维与配置展开核心讲解/hookify-configure命令如何在不删除规则文件的前提下交互式地启用或禁用现有.claude/hookify.*.local.md规则并顺带梳理 Hookify 从创建/hookify、查看/hookify-list到切换/hookify-configure与帮助/hookify-help的完整管理闭环。读完本文你将掌握 hookify 规则文件的前置元数据frontmatter结构、事件类型与动作语义能够熟练对单条或多条规则进行批量启停并了解如何在 Claude Code 的 hook 体系中让规则随时可切换、永不丢失。一、Hookify 规则体系速览为什么需要配置环节Hookify 是 ECC 提供的一套行为防护机制它通过生成携带 YAML frontmatter 的 Markdown 规则文件接入 Claude Code 的 hook 系统在bash、file、stop、prompt等事件触发时用自定义消息对 Agent 进行警告warn或阻止block从而预防对话分析或显式指令中暴露出的不良行为。规则文件统一存放在项目根目录的.claude/下命名规范为.claude/hookify.{name}.local.md详见 hookify 命令文档 与 hookify-rules 技能。正因为规则会随项目演进不断积累用户需要一套低成本的状态管理手段——这正是/hookify-configure的定位它只修改规则文件 frontmatter 中的enabled:字段达到开关而不删除的效果让规则可以随时保留、随时恢复。在 ECC 的命令注册表中该命令被归类为系统级System命令与hookify、hookify-list、hookify-help共同构成 Hookify 子系统见 COMMAND-REGISTRY.json。二、/hookify-configure交互式启停的完整流程根据 commands/hookify-configure.md该命令的执行流程分为六个明确步骤整个过程中 Agent 与用户保持交互发现规则文件查找项目根目录下所有.claude/hookify.*.local.md文件。文件名的*部分即规则名例如hookify.warn-debug-code.local.md对应规则warn-debug-code。读取当前状态解析每个文件的 frontmatter重点读取enabled:字段的当前值true或false同时可读取name、event、action、pattern等字段用于展示。呈现规则清单将规则以带状态的列表形式呈现给用户标明每条规则当前是启用enabled还是禁用disabled。确认切换目标询问用户希望切换toggle哪些规则支持选择单条或按名称批量指定。更新启用字段在所选规则文件中修改enabled:字段——原值为true的改为false原值为false的改为true完成启停切换。确认更改结果向用户确认哪些规则已被切换以及当前生效状态。从流程可以看出/hookify-configure的核心价值在于幂等且可逆它不新增、不删除规则只翻转开关因此误操作可以随时再切回来非常适合在某类防护暂时影响效率但未来仍需要的场景下临时关闭。三、规则文件格式与enabled字段的底层语义要正确理解配置命令的行为必须先读懂规则文件本身。Hookify 规则是YAML frontmatter Markdown 正文的复合结构正文内容为规则触发时展示给 Claude 的消息支持多行与 Markdown 格式化--- name: rule-name enabled: true event: bash|file|stop|prompt|all action: block|warn pattern: regex pattern --- Message shown when rule triggers.各 frontmatter 字段说明如下依据 hookify-rules 技能 整理字段必填取值说明name是kebab-case 字符串规则唯一标识建议动词开头warn-*、block-*、require-*enabled是true/false启停开关/hookify-configure只修改此字段event是bash/file/stop/prompt/all触发该规则的 hook 事件类型action否warn/blockwarn默认仅展示消息block阻止操作执行pattern是*正则字符串匹配模式复杂规则可用conditions替代enabled字段的存在使规则以声明式状态存在关闭规则不需要删除文件或注释代码只需将其置为false规则即可从生效集合中退出同时保留全部配置便于日后恢复。这即是 hookify.md 中所说与/hookify-list和/hookify-configure配合管理规则的落点。四、事件类型与动作语义配置前必知的基础知识在进行规则启停决策时需要理解不同事件与动作的组合效果才能在配置时准确判断该关哪条、该留哪条。依据 hookify-help.mdbash在 Bash 工具调用时触发pattern 匹配完整命令字符串。典型场景拦截危险命令rm\s-rf、提权操作sudo\s、权限问题chmod\s777。file在 Write/Edit 工具调用时触发pattern 匹配文件路径或内容。典型场景拦截调试代码console\.log\(、debugger拦截安全风险eval\(、innerHTML\s*关注敏感文件\.env$、\.pem$。stop在会话结束时触发用于完成度检查与提醒pattern.*表示始终匹配。prompt在用户消息提交时触发pattern 匹配用户输入用于强制工作流。all在所有事件上触发。动作方面warn只展示提示消息而不打断操作适合高频、低风险的提醒block则直接阻止对应操作适合必须拦截的硬性防护。在/hookify-configure中当发现某条block规则误伤正常操作时优先考虑临时禁用该规则切换到enabled: false比删除文件更安全。五、Hookify 规则管理的完整闭环创建、查看、配置、帮助/hookify-configure并非孤立命令它是 Hookify 治理链路的一环。四个命令各司其职命令职责关键行为/hookify [描述]创建新规则无参数时调用conversation-analyzer分析当前对话挖掘显式纠正、对重复错误的挫败反应、被回退的改动、反复出现的相似问题生成规则文件/hookify-list列出所有规则读取每个文件的name、enabled、event、action、pattern以表格呈现并显示规则总数/hookify-configure交互式启停规则展示当前状态 → 询问切换目标 → 更新enabled字段 → 确认结果/hookify-help查看完整文档输出事件类型、规则格式、命令说明与 pattern 编写建议创建时生成的规则默认enabled: true见 hookify.md 的模板之后用/hookify-list查看全量状态与规则数量并在文末提示可用/hookify-configure随时变更状态见 hookify-list.md需要调整时再用/hookify-configure完成切换。这一闭环保证了规则从诞生、运行到停用的全生命周期可观测、可管理。六、结合源码与仓库的纵深理解命令注册与归类在 docs/COMMAND-REGISTRY.json 中hookify-configure的注册描述为 Enable or disable hookify rules interactively与hookify、hookify-list、hookify-help一并登记佐证了四个命令属于同一功能族ECC 的仪表盘脚本也将hookify前缀映射到 System系统类目见 scripts/dashboard-web.js说明该子系统在 ECC 命令体系中被视为基础设施级能力。技能层的一致性保障编写规则的完整规范沉淀在 skills/hookify-rules/SKILL.md 中其中除pattern单条件外还支持conditions多条件组合如field: file_pathoperator: regex_matchpattern: \.env$与field: new_textoperator: containspattern: API_KEY同时命中才触发字段可用性按事件区分bash:commandfile:file_path/new_text/old_text/contentprompt:user_prompt操作符包括regex_match、contains、equals、not_contains、starts_with、ends_with。无论规则多么复杂/hookify-configure都只操作最外层的enabled开关与规则内部结构解耦因此对复杂规则同样适用。七、实战要点与注意事项规则文件位置.claude/位于项目根目录命名必须遵循hookify.{name}.local.md否则无法被三个命令发现。版本管理与隐私建议将.claude/*.local.md加入.gitignore见 hookify-rules 技能 的文件组织说明规则属于个人/项目本地配置不应混入公共仓库。pattern 编写避坑避免过宽匹配如log会误中 login、dialog应写console\.log\(避免过死匹配如rm -rf /tmp应放宽为rm\s-rfYAML 引号内使用正则时需注意转义如\\s。上线前自测可用 Python 快速验证正则是否按预期命中python3 -c import re; print(re.search(ryour_pattern, test text))启停语义/hookify-configure只翻转enabled字段不删除文件若规则长期不再需要应先用/hookify-list确认状态再决定是禁用还是清理文件。总结/hookify-configure是 Hookify 规则治理中运行时开关的关键一环它以 6 步交互流程完成规则发现、状态展示、目标确认与enabled字段更新配合/hookify创建、/hookify-list查看、/hookify-help文档让开发者能够以文件即配置、开关即管理的方式在 Claude Code 的 hook 体系上建立一套可审计、可回滚的行为防护层。理解其底层规则文件结构与事件/动作语义是高效使用该命令的前提——这也正是从会执行命令到会治理规则的进阶所在。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考