菜单
Invoked after a failed npm publish to classify the failure, take the right recovery action, and retry once. Called automatically by the PostToolUse hook — the user rarely invokes this directly.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
One-time per-package setup — writes an entry in `~/.config/npm-helper/state.json` mapping a package to its 1Password item, GitHub repo, publish workflow, GH secret, and optional Vercel mirrors. Run this once before `/npm-publish` will work on a new package.
Read-only diagnosis of npm ↔ 1Password ↔ GitHub Actions credential drift for a package. Reports what's stale and what to do. Side-effect free.
One-shot npm publish — detects package, syncs credentials, bumps version, tags, pushes, tails the workflow, classifies failures, recovers automatically where possible. Use when the user says "publish this", "ship it", "release npm", or similar.
Rotate the npm publish token for a package to a fresh granular+bypass-2fa token, update 1Password and the GitHub Actions secret. Use when publishes hit E403/EOTP and /npm-doctor says the token needs replacing.
Change the npm account 2FA level between disabled, auth-only, and auth-and-writes. Use when /npm-doctor reports account 2FA is blocking automation tokens.
| name | npm-unstick |
| description | Invoked after a failed npm publish to classify the failure, take the right recovery action, and retry once. Called automatically by the PostToolUse hook — the user rarely invokes this directly. |
Unstick a failed publish in one shot instead of pinging the user twelve times.
npm publish stderr from scrollback or from the hook's additionalContext hint.npm.classify_error. Returns one of:
{ action: "flip-2fa-auth-only" }{ action: "rotate-granular-token" }{ action: "reset-password", blocking: true }{ action: "retry", after_seconds: N }{ action: "fix-publishconfig", fix: { ... } }{ action: "unknown", stderr: "..." } → print and ask user/npm-set-2fa, /npm-rotate-token, /npm-doctor).retry → wait and re-run the exact same npm publish or git push --tags.fix-publishconfig → patch the file, commit, retry.reset-password is blocking because it needs the human).unknown, do not guess — print stderr and stop. Unknown failures go into the classifier test fixtures for next time.