SuperAPI AI 工具集

file-watcher

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:File Watcher 用于在 Claude Code 中配置文件监听钩子,对配置文件变更、.env 文件更新和依赖修改做出自动响应,适合搭建响应式开发工作流。

主要能力:利用 SessionStart 和 CwdChanged 钩子返回 watchPaths 注册文件监听;被监听文件变化时触发 FileChanged 钩子,携带 file_path 和 event 信息。CwdChanged 与 FileChanged 钩子可写入 CLAUDE_ENV_FILE,向后续 Bash 命令注入环境变量。常见模式包括监听 .env、package.json(依赖变化时提醒运行 npm install)、tsconfig.json(配置变化时提醒重启 TypeScript 检查)。

使用方式:在钩子脚本中输出含 hookSpecificOutput、hookEventName 和 watchPaths 的 JSON 结构注册监听;在 hooks.json 中配置 FileChanged,matcher 使用竖线分隔的文件名,command 指向处理脚本,例如 node scripts/file-changed.js。注入环境变量使用 echo "export PROJECT_TYPE=node" >> "$CLAUDE_ENV_FILE"。

限制:watchPaths 必须使用绝对路径;监听器采用 500ms 稳定阈值和 200ms 轮询间隔;file-changed 处理程序应保持快速(5 秒内)以免阻塞;环境变量应通过 CLAUDE_ENV_FILE 注入而非直接 export。当前 cwd-changed.js 脚本主要处理环境注入,需自行添加监听注册逻辑。具体安装与完整配置细节暂未提供。