SuperAPI AI 工具集

groove-admin-cursor-hooks

通用与其它

查看项目

更新于 10-15 16:49

技能介绍

用途:把 groove 的 Cursor 原生钩子安装到 .cursor/hooks.json。这些钩子在模型之外运行,确定且无条件执行,与 groove 的提示性 markdown 钩子(.groove/hooks/start.md、end.md)互补。

主要能力(六个可选钩子):context-reprime(sessionStart,运行 prime 脚本 --json,确保每次会话开始和压缩后加载完整工作流上下文);daily-end-reminder(stop,本地 16–21 点且 .groove/index.md 存在时提醒运行 /groove-daily-end);git-activity-buffer(postToolUse/Shell,命令含 git commit 时向 .groove/.cache/git-activity-buffer.txt 追加带时间戳记录);block-managed-paths(preToolUse/Write,file_path 以 .agents/skills/groove 或 skills/groove 开头时以退出码 2 阻止写入并给出说明);version-check(postToolUse,每小时检查一次新版本,调用 groove-utilities-check);session-capture(stop,有 Git 活动时把捕获草稿暂存到 .groove/.cache/pending-capture.md 供下次会话查看,静默)。

使用方式:默认安装会询问启用哪些钩子(默认全部六个,可输入 all 或逗号分隔列表)。读取并解析现有 .cursor/hooks.json,保留所有非 groove 条目,创建 .groove/hooks/cursor/ 目录并 chmod +x 脚本,然后把钩子条目合并进 .cursor/hooks.json。--list 报告已注册钩子与脚本存在情况;--disable <hook> 从 .cursor/hooks.json 移除指定钩子条目(脚本保留)。安装后钩子需在下次 Cursor 会话重启后生效。

限制与约束:不得覆盖 .cursor/hooks.json 中的非 groove 条目;不得在未展示 diff 并确认的情况下覆盖已有脚本;脚本依赖 python3 解析 JSON stdin,缺失时跳过该钩子并警告;block-managed-paths 使用退出码 2;.groove/hooks/cursor/ 遵循 .groove/index.md 中的 git.hooks 策略;.cursor/ 目录不存在时创建。官方文档未提供更多钩子行为细节。