القائمة
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 |