讓惡意Skill進(jìn)不了倉庫Skill Scanner pre-commit鉤子配置實(shí)戰(zhàn)教程【免費(fèi)下載鏈接】skill-scannerSecurity Scanner for Agent Skills項(xiàng)目地址: https://gitcode.com/gh_mirrors/sk/skill-scannerSkill Scanner 是一款面向 AI Agent Skill 的安全掃描工具它的skill-scanner-pre-commit鉤子可以在你git commit的瞬間自動掃描暫存的 Skill發(fā)現(xiàn) HIGH 或 CRITICAL 級安全問題時(shí)直接攔截提交——把惡意 Skill 擋在倉庫之外。本教程帶你用 3 步完成 pre-commit 鉤子配置并調(diào)出最適合團(tuán)隊(duì)的攔截策略。鉤子如何攔截惡意提交鉤子的核心邏輯很簡單分為三步定位受影響的 Skill從暫存區(qū)staged diff讀取變更文件向上查找最近的SKILL.md鎖定被修改的 Skill 目錄運(yùn)行掃描復(fù)用 Skill Scanner 的完整分析器規(guī)則匹配、觸發(fā)器分析等毫秒級完成按閾值裁決只要檢出結(jié)果達(dá)到severity_threshold默認(rèn)high及以上就返回非零退出碼提交失敗。沒有改動任何 Skill 的提交會直接放行不會拖慢你的日常開發(fā)。一鍵安裝 pre-commit 鉤子安裝 Skill Scanner 后在你的倉庫根目錄執(zhí)行skill-scanner-pre-commit --install它會自動在.git/hooks/pre-commit寫入一個調(diào)用skill-scanner-pre-commit的鉤子腳本并賦予執(zhí)行權(quán)限。若鉤子已存在會提示是否覆蓋。 鉤子入口點(diǎn)在 pyproject.toml 中注冊為skill-scanner-pre-commit命令實(shí)現(xiàn)位于 skill_scanner/hooks/pre_commit.py。如果不想用內(nèi)置安裝方式也可以直接使用倉庫提供的 Shell 版鉤子腳本 scripts/pre-commit-hook.sh復(fù)制到.git/hooks/pre-commit即可。用 .skill_scannerrc 配置攔截策略在倉庫根目錄創(chuàng)建.skill_scannerrc文件也支持.skill_scannerrc.json或skill_scanner.json即可定制行為配置項(xiàng)默認(rèn)值作用severity_thresholdhigh達(dá)到該級別critical/high/medium/low即攔截提交skills_path.claude/skillsSkill 目錄的根路徑fail_fasttrue遇到第一個超限 Skill 即停止use_behavioralfalse是否啟用行為分析器use_triggertrue是否啟用觸發(fā)器特異性分析policy默認(rèn)策略策略預(yù)設(shè)名或自定義策略 YAML 路徑官方推薦團(tuán)隊(duì)寫 Skill 時(shí)使用低噪音預(yù)設(shè) HIGH 攔截既快又幾乎不誤傷{ skills_path: .claude/skills, severity_threshold: high, policy: low-noise, fail_fast: true }該配置思路來自 docs/user-guide/recommended-settings.md。接入 pre-commit 框架可選如果你團(tuán)隊(duì)已使用 pre-commit 框架管理各類鉤子在.pre-commit-config.yaml中加入本地鉤子即可repos: - repo: local hooks: - id: skill-scanner name: Skill Scanner entry: skill-scanner-pre-commit language: python pass_filenames: false always_run: true常用命令速查命令用途skill-scanner-pre-commit --install安裝內(nèi)置 Git 鉤子skill-scanner-pre-commit --scan-all掃描全部已配置 Skill而非僅暫存的skill-scanner-pre-commit --severity medium臨時(shí)提高攔截嚴(yán)格度skill-scanner-pre-commit --skills-path .cursor/skills臨時(shí)指定 Skill 路徑skill-scanner-pre-commit --lenient容忍格式不規(guī)范的 Skill不直接報(bào)錯在 CI 中沒有暫存區(qū)時(shí)可以用兩個 ref 對比來跑鉤子pre-commit run skill-scanner --from-ref $BASE_SHA --to-ref $HEAD_SHA兩個版本必須都存在于當(dāng)前 checkout 中。提交被攔截了怎么辦鉤子失敗時(shí)終端會列出每條發(fā)現(xiàn)的級別、標(biāo)題和具體位置文件 行號。修復(fù)問題后重新提交即可緊急情況下可用git commit --no-verify繞過——但不推薦這會讓惡意模式溜進(jìn)倉庫。??延伸閱讀鉤子實(shí)現(xiàn)源碼skill_scanner/hooks/pre_commit.pyShell 備用鉤子scripts/pre-commit-hook.sh功能與集成總覽docs/features/index.md推薦配置與實(shí)測數(shù)據(jù)docs/user-guide/recommended-settings.md快速上手docs/getting-started/quick-start.md配置完成后每一次提交都自帶安全體檢——讓惡意 Skill 在進(jìn)倉庫之前就被攔截正是 Skill Scanner pre-commit 鉤子的價(jià)值所在?！久赓M(fèi)下載鏈接】skill-scannerSecurity Scanner for Agent Skills項(xiàng)目地址: https://gitcode.com/gh_mirrors/sk/skill-scanner創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考