mcpField
H
hook-scope-guide

hook-scope-guide

github.com/atholaAgent 工作流34370 次安装1 天前更新
代码仓库

关于 hook-scope-guide

hook-scope-guide 是 Claude Code 技能，帮助根据受众、版本控制和持久性需求，为钩子选择插件、项目或全局范围。它提供决策指引，并要求确认对应配置位置及全局钩子的安全影响。

主要功能

  1. 01按受众、版本控制和持久性选择范围
  2. 02区分插件、项目与全局钩子
  3. 03确认对应的配置文件位置
  4. 04检查全局钩子的安全影响

适用场景

  1. 01为团队共享且需提交的钩子选定范围
  2. 02决定仅适用于个人会话的钩子位置
  3. 03规划随插件启用的钩子配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/athola/claude-night-market --skill hook-scope-guide

安装后在 Claude Code 中输入/hook-scope-guide确认已加载。

详细介绍

Hook 作用域选择指南

概述

此技能可根据 Hook 的用途、受众和持久性需求，帮助你为 Claude Code Hook 选择合适的位置。

不适用场景

  • 编写 Hook 本身（使用 abstract:hook-authoring）
  • 评估现有 Hook（使用 abstract:hooks-eval）

决策框架

回答三个问题即可确定作用域：谁需要此 Hook、是否应将其纳入版本控制，以及它应持续多久。插件 Hook（插件中的 hooks/hooks.json）服务于启用该插件的用户。项目 Hook（.claude/settings.json）服务于团队，并会提交到版本库。全局 Hook（~/.claude/settings.json）只服务于你，在每个会话中生效，且永远不会提交到版本库。

问题树、各作用域的配置和示例、加载优先级、安全注意事项、迁移及故障排除都集中写在 plugins/abstract/skills/hook-authoring/modules/scope-selection.md 中。 选择作用域前请先阅读。可感知 Agent 的 SessionStart Hook 见 abstract:hook-authoring 中的 Hook 事件类型章节。

相关技能

  • abstract:hook-authoring - Hook 规则语法和模式
  • abstract:validate-plugin - 验证插件结构，包括 Hook

参考资料

退出条件

  • 已选定单一作用域（插件 / 项目 / 全局），且选择理由至少对应三个决策问题中的两个（受众、版本控制、持久性）。
  • 已确认所选作用域的文件位置（hooks/hooks.json、.claude/settings.json 或 ~/.claude/settings.json）存在，或已在正确路径创建该文件。
  • 插件 Hook 不会在 plugin.json 中添加 "hooks": "./hooks/hooks.json"（防止重复加载）；部署 Hook 前已确认不存在此项。
  • 全局 Hook 已标注安全说明，确认其适用于此设备上的所有 Claude 会话。

评论

支持 Markdown