SuperAPI AI 工具集

hookshot

智能体与模型

查看项目

更新于 10-15 21:41

技能介绍

用途:把仓库已写好的文档转成运行时执行钩子,让编码智能体在编辑前先读相关文档,并为关键路径加提示或门禁。由 fellowship-dev/dogfooded-skills 提供,安装命令为 npx skills add fellowship-dev/dogfooded-skills/ops/hookshot。

主要能力与模式:默认(无参数)生成文档覆盖钩子,在 Edit/Write 前提示智能体阅读对应 docs/ 章节;--drift-warn 在编辑 .claude/skills/<name>/ 且该技能记录于 skills-lock.json 时警告应改上游;--md-lint 在编辑后对改动的 .md 运行 npx markdownlint-cli2 并显示警告,不自动修复;--preflight 提供 SessionStart 钩子,告知 session id、预检任务与 outcome-contract 记录位置;--gate 提供 Stop 钩子,按 outcome contract 比对,shadow 只记录、enforce 拒绝停止。各标志可组合,重复运行会幂等合并已有钩子。

生成物:.claude/doc-coverage.json(文件 glob 到文档章节的覆盖映射)、.claude/check-docs.sh、.claude/settings.json 中的 PreToolUse/PostToolUse/SessionStart/Stop 钩子、自定义 lint 消息与 docs/hooks.md。可手动调 doc-coverage.json 微调,或重跑 /hookshot 重新生成,人工新增内容会保留。

适用场景:setup-harness 完成后接线知识层、docs/code-structure.md 或 docs/code-guidelines.md 更新后、出现智能体未读文档即修改关键路径的问题后、新增 FlowChad flow 后。

限制:默认只警告不阻断,仅 delivery gate 可切换强制;不修改文件、不做 lint 自动修复;需先运行 /hookshot 才生成产物;glob 使用 bash [[ ]] 匹配,** 与 gitignore 语义不同,[brackets] 需转义;--preflight、--gate 才附带脚本并额外安装进 Codex;跨仓库任务使用目标仓库的钩子。收费标准与具体平台支持资料暂未提供。