SuperAPI AI 工具集

hooks-session-end-issue-hook

通用与其它

查看项目

更新于 10-15 23:49

技能介绍

用途:为 Claude 配置 Stop 钩子,在每次响应结束时检查最后一次 TodoWrite 调用中的待办状态,若存在 status 为 pending 或 in_progress 的待办,则输出阻断决定并给出待办清单与建议的 gh issue create 命令,让 Claude 有机会创建 issue 或询问用户处理方式。适用于希望将未完成待办转为 GitHub issue、避免任务在会话结束时被遗忘、且项目使用 GitHub issue 跟踪的场景。

主要能力:检测最后一次待办状态;无未完成待办时静默退出,不打断会话;存在未完成待办时阻断并列出待办与建议命令;建议 issue 标签 claude-deferred(仅建议,不自动应用)。

使用方式:先检查前置条件,确认已安装 jq(钩子解析会话记录所需),除非传入 --no-verify,否则需检查 gh 是否已安装并已认证(gh auth status)。随后定位钩子脚本:若设置了 ${CLAUDE_PLUGIN_ROOT},使用 ${CLAUDE_PLUGIN_ROOT}/hooks/session-end-issue-hook.sh;否则查找技能位置相对的 ../../hooks/session-end-issue-hook.sh;再不行则询问用户已安装 hooks-plugin 的绝对路径。之后读取已有 .claude/settings.json 并合并 Stop 钩子,保留现有配置;若已存在指向该脚本的 Stop 钩子则跳过,若存在其他 Stop 钩子则一并运行。配置内容为 Stop 事件、matcher 为 *、command 为 bash "${CLAUDE_PLUGIN_ROOT}/hooks/session-end-issue-hook.sh"、timeout 为 15。若 .claude 目录不存在则创建。最后报告脚本路径、settings.json 位置及 gh 认证是否就绪。

限制:需要 jq;GitHub issue 创建依赖 gh 已认证,未认证时需运行 gh auth login;钩子每次响应结束都会触发,仅在存在未完成待办时阻断;未提供关于收费或平台支持的更多信息。