菜单
Detect and surface missing-native-binary errors (e.g. @rollup/rollup-darwin-arm64) without mutating node_modules or the lockfile.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Canonical linear DB migrations under infra/k8s/base/ops/source/database/linear-migrations, ops bundles, env keys, and runners. Use when adding or changing SQL migrations, K8s DB bootstrap, or scripts/database in this repo.
When an E2E test verifies a specific element, pass it to the capture helper so the step screenshot is taken with that element vertically centered.
Create and use Metaboost git worktrees in sibling directories named metaboost_<branch_slug> (underscores). Use when starting feature work, moving WIP off the main checkout, or opening the correct worktree path for a branch.
Distributed tracing and OTLP export patterns. Use when adding trace context, log correlation, or Observability env — after Metaboost adopts a shared observability package.
When you finish a plan file in active/, automatically move it to completed/. If it's the last plan in its set, move the whole set. Use when completing any plan under .llm/plans/active/.
User vocabulary abcmemory and abcremember — where Cursor guidance lives and how to persist new instructions. Use when the user says abcmemory or abcremember.
| name | native-deps-platform-mismatch |
| description | Detect and surface missing-native-binary errors (e.g. @rollup/rollup-darwin-arm64) without mutating node_modules or the lockfile. |
| version | 1.0.0 |
The Metaboost lockfile is Linux-canonical but lists optional deps for every platform (see
LOCKFILE-LINUX.md). The repo also has a Docker-based
script (scripts/development/update-lockfile-linux.sh)
that regenerates the lockfile; after it runs on macOS, the host's node_modules no longer has
darwin native binaries until the host runs npm install again.
Errors like:
Cannot find module @rollup/rollup-darwin-arm64Cannot find module @next/swc-darwin-arm64Cannot find module @parcel/watcher-darwin-arm64Cannot find module sharp (when prebuilt platform binary is missing)npm install on the host — this materializes the platform-specific optional
deps already listed in the lockfile and does not modify package-lock.json.update-lockfile-linux.sh, point them at the "After running on macOS"
section of LOCKFILE-LINUX.md.npm install, npm ci, npm rebuild, npm install --no-save, or
npm install --no-save --no-package-lock autonomously. These mutate node_modules and may mutate
package-lock.json in subtle ways across platforms.node_modules is the broken
artifact.npm ci itself is fine. The CI Dockerfiles under infra/docker/local/** use it intentionally. The
agent failure mode this skill prevents is running mutating commands speculatively while debugging a
missing-binary error — which can corrupt the lockfile or hide the underlying environment problem from
the user.