SuperAPI AI 工具集

startup-hook-skill

编程与开发

查看项目

更新于 11-14 23:35

技能介绍

用途:该技能面向 Claude Code 云会话,用于在仓库中创建并提交 SessionStart 钩子,在会话启动时安装项目依赖,从而让测试和代码检查工具在会话中可用。资料明确限定:仅当用户要求创建提交到其仓库的 SessionStart 钩子时使用;如果用户只是要求设置环境,则应停止、不提交任何内容。

主要能力与机制:钩子通过 stdin 接收会话信息(session_id、source、transcript_path、permission_mode、hook_event_name、cwd)。支持异步模式,通过脚本输出 {"async": true, "asyncTimeout": 300000} 让钩子在后台运行,降低延迟,但会引入竞态条件:代理循环可能在启动钩子完成前依赖尚未就绪的内容。可用环境变量包括 $CLAUDE_PROJECT_DIR(仓库根路径)、$CLAUDE_ENV_FILE(写入持久化环境变量的路径)和 $CLAUDE_CODE_REMOTE(判断是否在远程云会话中),可据此仅对远程环境执行脚本。

使用方式与工作流:先建立任务清单并逐项执行。1)分析依赖:查找 package.json/lock、pyproject.toml/requirements.txt、Cargo.toml、go.mod、Gemfile 等清单,并阅读 README 等文档补充环境信息。2)设计钩子:首轮不使用异步模式(除非用户要求);默认只针对 Web 环境(除非用户另说);利用容器在钩子完成后缓存状态的特性,偏好 npm install 而非 npm ci;保证幂等,通过哈希文件检查安装是否已成功且清单未变,以跳过重复安装;哈希文件放在安装填充的目录内并确保被 git 忽略;pip 安装到系统 Python 时使用该系统 Python 纯库目录下独立的哈希文件,并用同一 Python 的 pip;Python 需对 requirements 通过 -r/-c 引入的文件逐一计算哈希;仓库自身的包用 pip install -e . 可编辑安装;apt 与全局工具放在检查之外并仅安装缺失项(如 shellcheck、libpq-dev),版本需匹配仓库固定要求;脚本保持非交互。3)创建钩子文件 .claude/hooks/session-start.sh 并赋予执行权限。4)在 .claude/settings.json 中注册 SessionStart 钩子(存在则合并)。5)验证:以 CLAUDE_CODE_REMOTE=true 直接运行脚本,确认依赖安装且脚本成功;再次运行确认跳过所有安装;逐一修改被哈希文件内容验证重新安装后恢复。6)验证 linter:确定正确命令并仅对示例文件运行。7)验证测试:确定正确命令并仅运行一个测试。8)提交并推送。最后向用户提供变更摘要与验证结果清单,说明钩子为同步模式及其权衡:优点是保证会话开始前依赖就绪、避免竞态;缺点是远程会话需等钩子完成才启动;可改用异步以加快启动。并告知用户合并到默认分支后,所有未来会话都会使用该钩子。

适用场景:需要在 Claude Code 云会话中自动准备依赖、确保测试与 linter 可用的仓库。

限制:仅用于用户明确要求提交 SessionStart 钩子的情形;不负责一般环境配置;异步模式可能产生竞态;钩子在每次会话启动、恢复、清除和压缩时都会运行,同步钩子会阻塞用户消息直至结束;资料未提供价格、平台范围等其它信息。