用途
Supply Chain Defense 用于防御被投毒的 npm、PyPI、Composer、Cargo 包，恶意编辑器扩展，以及配置即代码形式的仓库污染。它针对 2026 年出现的供应链蠕虫（Shai-Hulud / Mini Shai-Hulud）设计：这类攻击会污染热门 npm 与 PyPI 包、窃取凭据、用窃取的令牌重新发布，并在 Claude Code 与 VS Code 设置中植入持久化钩子。
该技能定位为「主动的一半」，在包刚发布、官方 advisory 尚未发布的窗口期判断新包的行为；而 security-ops 是「被动的一半」，依赖 CVE 数据库进行 npm audit / pip-audit。资料称，2026 年锁文件、npm audit、2FA 甚至 Sigstore/SLSA 溯源都被逐一绕过。
主要能力
核心例行流程针对每一次安装或版本升级：
- 打分：使用 depscore MCP（免费、无需 key）或
socket package score <eco> <name> <version>，对整份 manifest 而非仅新包打分。 - 冷却期检查：运行
bash scripts/preinstall-check.sh <pkg>[@ver] ...（支持 --pip、--composer、--cargo、--go）；退出码 10 表示发布不足 7 天冷却期。不建议在生产路径使用 day-zero（@latest）版本。 - 带门安装：
socket npm install <pkg>，或完全禁用生命周期脚本（npm config set ignore-scripts true）。 - 锁定：提交 lockfile；CI/生产使用精确版本。
资料强调不要止步于 npm audit 通过，因为它只知道昨天的 CVE。
技能按情境提供 A–L 工作流，覆盖：新增/升级依赖、团队或 CI 刚拉取新版本、audit 通过但仍不安、预算内推广 Socket.dev、安装命令需加门、CI 发布到 npm/PyPI、生产依赖自动更新、编辑器扩展/Claude 插件与技能、本机是否已被入侵、advisory 点名某包或扩展、Windows 上不明的 UAC 或进程/事后触发监控、磁盘上已有异常行为、自有仓库被就地投毒。
使用方式
脚本路径相对于技能文件夹，.py 脚本需通过 scripts/run-python.sh 启动。资料给出以下脚本：
preinstall-check.sh：判断发布是否在冷却期内。integrity-audit.sh：检查 AI 工具、编辑器、shell 或包管理器配置中是否已植入蠕虫，以及 OIDC 发布信任。exposure-check.py：检查是否安装了被点名的坏包或扩展。postinstall-audit.py：检查已安装包是否有恶意行为，支持 --deep、--live。config-drift-check.py：检查构建配置或 tasks.json 是否被注入加载器。scan-extensions.sh：检查近期变化的扩展、插件与技能。phone-home-monitor.ps1：查看哪些进程发起外连（Windows）。
除 phone-home-monitor.ps1 的 -InstallTask 外均为只读。共享退出码：0 正常，2 用法错误，3 未找到，5 缺依赖，7 不可用，10 表示发现（需复核/在冷却期/暴露/行为命中）。5 和 7 表示部分检查未运行，绝不等于通过。所有脚本支持 --json。
设置方面，脚本无需配置；可选的实时工具按优先级：depsocre MCP（claude mcp add --transport http socket-mcp https://mcp.socket.dev/）、安装钩子、Socket CLI 包装器（npm i -g socket）、行为引擎（uv tool install guarddog semgrep，用于 --deep）。资料称免费 Socket 层级足以覆盖整个攻击活动，付费层级购买的是可达性与席位而非检测能力。
适用场景
防御的六层控制：检测（Socket.dev 行为扫描）、拦截（socket wrapper、ignore-scripts、安装钩子）、卫生（陈旧 OIDC 审计、冷却期、令牌轮换、扩展审计）、自身完整性与暴露（integrity-audit.sh、exposure-check.py）、安装后行为（postinstall-audit.py、phone-home-monitor.ps1）、仓库完整性（config-drift-check.py 加签名提交、禁 force-push、不共享密钥）。第 1–3 层在代码运行前生效，4–5 层假设已有东西进入并追查，第 6 层针对包从未进入的配置即代码投毒。
资料还提供安全分级（T1 内联、T2 内联/后台、T3 需确认）、反模式说明（如依赖 npm audit、过度信任溯源、生产依赖自动更新、信任已认证发布者的扩展、遗留 id-token: write、只删除持久化钩子而不轮换凭据）以及验证清单。发现 H–L 类问题应视为事故：隔离机器、轮换其可读取的所有凭据，再调查；仅移除钩子或包只是治标。
限制
资料未提供具体价格信息，仅说明免费与付费层级的存在及免费层级足以覆盖该活动。脚本的部分检查在缺少 jq、注册表宕机或日志需提权时无法运行（退出码 5 和 7），不构成通过。--deep 所需行为引擎默认不安装；Windows 上 GuardDog 需要 PYTHONUTF8=1。其余功能、平台与效果限制资料中暂未提供。