Community编程与开发github.com

steipete/npm

npm 注册表操作:登录、whoami、包名检查、发布;集成 1Password 与 tmux。

npm 是什么?

该技能为 AI 代理(如 Claude Code)提供了一套完整的 npm 注册表操作任务自动化工具,包括身份认证、包名查询与保留、包发布以及组织成员检查等。它深度集成了 1Password 进行凭证管理,优先通过服务账户令牌自动认证,并回退到用户名/密码/OTP 登录流程。所有认证操作均在持久的 tmux 会话中执行,避免重复交互。技能包含了多个辅助脚本(如 `scripts/npm-auth.sh`、`publish-package.sh`、`reserve-packages.sh`),能够自动处理 OTP 刷新、版本检查、发布失败重试以及临时文件清理等细节。它支持 macOS 桌面环境,但尽可能避免桌面解锁提示,仅在明确的发布请求下才请求用户交互。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/npm

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

npm 是做什么的?

用于执行 npm 注册表/账户相关任务:npm whoami、包可用性检查、包保留、发布、组织验证以及认证调试。

认证

  • 优先使用 one-password 进行密钥规则操作。
  • 绝对不要在 shell 工具中直接运行 op。
  • 主条目:npm Registry - steipete - Release Automation,存储在 Molty 保管库。
  • 默认使用 OP_SERVICE_ACCOUNT_TOKEN;不需要桌面解锁。该条目包含有效的注册表会话(registry_token)以及用户名/密码/TOTP 回退信息。
  • 桌面 npmjs 回退仅在明确指定时使用:当 Molty 不可用且用户希望回退时,传递 --account my.1password.com。明确的 release/publish 请求即视为同意触发解锁提示。
  • 遇到以下情况应停止并询问:条目缺失、账户或保管库不明确、凭据格式错误、npm 拒绝包访问、或请求的包/版本与仓库发布目标不匹配。
  • 在一个持久的 tmux 会话中执行所有 npm 认证工作。失败时重用该会话。
  • 将 npm 认证信息保存在临时 npmrc 中;命令执行完毕后删除。
  • 所有辅助脚本共享 scripts/npm-auth.sh:优先使用已存储的 registry_token 会话,然后使用 scripts/npm-auth-login.mjs 通过六位数一次性密码进行注册表登录;成功的回退会话将被缓存回同一个条目。不要手动实现字段提取、注册表登录或缓存写入。
  • 凭据选择优先级:首选规范的 id 字段,然后是 purpose 字段,最后是唯一的标签;重复标签的匹配将被拒绝(旧版 npmjs 可能保留相同标签的字段)。
  • 对于临时性的已认证注册表命令,使用 scripts/npm-service.sh -- <npm args...>;对于本地包发布,使用 publish-package.sh。
  • npm 11 的提示符管道化不够稳定;避免使用 printf ... | npm login --auth-type=legacy。
  • 除非必要,否则避免对 npm 登录使用 expect;日志可能泄露提示信息,且容易出错。
  • 自动化场景下,更推荐使用辅助脚本的注册表 API 登录路径(npm-profile 的 loginCouch)。
  • 如果认证形态不明确或 npm whoami 失败,停止并询问确切的字段标签或凭据修正。不要探测更多 1Password 条目或启动新的 tmux 会话。

包发布

在包根目录中,在同一个认证 tmux 会话内执行:

/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh

该辅助脚本会验证身份、拒绝发布已存在的包版本、使用新的一次性密码发布、重试一次过期的一次性密码、验证注册表可见性,并清理认证文件。

包保留

在同一个 tmux 会话中使用 scripts/reserve-packages.sh:

/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh package-one package-two

功能说明:

  • 通过 op 一次性读取 Molty 保管库中的 release-automation 条目
  • 重用已存储的注册表会话,或通过用户名/密码/TOTP 创建新会话
  • 发布带有通用 README 的 0.0.0 占位包
  • 在每个包发布失败后继续执行后续操作
  • 在日志中遮盖令牌/一次性密码
  • 清理临时 npmrc 和工作目录

注意事项:

  • npm 可能会因包名与已发布的包名过于相似而拒绝。这应视为注册表策略结果,而非认证失败。
  • npm 11 的 CLI 提示符管道化不够稳定。建议优先使用辅助脚本的注册表 API 登录路径,而非脚本化的 npm login。
  • 对于作用域包,npm view 可能延迟或返回 404,即使包已存在。请使用 npm access get status <pkg> 检查;返回 public 或发布失败报错 previously published versions 表示该名称已被保留。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相关技能