메뉴
Node.js 项目管理。npm/pnpm init、依赖管理、scripts、nvm、常见故障（node_modules、lock 文件）。涉及 Node 项目初始化或依赖问题时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
生成或审计模块的 SPEC.md。使用场景：用户要求"给 XX 模块写 spec"、"审计所有 spec"、"检查 spec 是否过期"。
Automates SailFish release workflow: fix build/type errors, update CHANGELOG (EN + CN), run npm version with pre/post hooks. Use when the user asks to release, 发版, 发布, bump version, or update changelog.
后端代码修改后，通过 CLI 测试验证功能正确性。使用场景：修改了 electron/services/ 下的代码需要测试、准备提交代码前跑回归、用户要求"跑测试"/"验证一下"。
完成新功能开发或较大修改后，使用本机 Claude CLI 进行代码审查。
使用 ts-morph 静态分析工具查询代码结构（类层次、方法签名、引用、依赖等），替代手动读源码。使用场景：需要了解类的方法/属性、继承链、符号引用、文件结构、依赖关系时。
When committing or staging changes, only include files related to the current task or conversation; do not stage or commit unrelated modifications. Use when the user asks to commit, stage, 提交, or when preparing to run git add/commit.
| name | node-project |
| description | Node.js 项目管理。npm/pnpm init、依赖管理、scripts、nvm、常见故障（node_modules、lock 文件）。涉及 Node 项目初始化或依赖问题时使用。 |
| version | 1.0.0 |
npm init -y
pnpm init
# 安装
npm install lodash
npm install -D eslint
pnpm add lodash
pnpm add -D eslint
# 更新
npm update
npm outdated
pnpm update
建议：提交 package-lock.json 或 pnpm-lock.yaml，保证环境一致。
{
"scripts": {
"dev": "vite",
"build": "vite build",
"test": "vitest"
}
}
运行：npm run dev、pnpm dev
nvm install 20
nvm use 20
nvm alias default 20
项目指定版本：.nvmrc 写 20 或 18.0.0，配合 nvm use。
| 问题 | 处理 |
|---|---|
node_modules 异常 | 删 node_modules 和 lock 文件后重装：rm -rf node_modules && npm install |
| lock 文件冲突 | 团队统一用 npm 或 pnpm，不要混用；冲突时以 lock 为准或重生成 |
| 全局 vs 项目 | 依赖尽量装到项目，少用 npm install -g |
| 权限错误 | 避免 sudo npm；修复 npm 目录权限或用 nvm |
| 安装慢 | 换镜像：npm config set registry https://registry.npmmirror.com |