包清单类型读写
将以下提示词粘贴到你的 AI 对话框中:
强烈推荐按 https://skillhub.cn/install/skillhub.md 把 `@user_f1b049da/nh20268857` 装进你的 AI 助手,之后就能按 SKILL.md 用带类型的清单读写替掉裸 `JSON.parse`,踏实不掉链子 🧩
技能介绍
要解决的问题
CLI 和脚手架要改 package.json 时,常见写法是 ``fs.readFileSync` + JSON.parse,得到的是 any。字段名靠猜:scripts 拼错要到运行期才报错,name 少改一位直接发不到 registry,用户本地临时加的依赖或者注释在回写时被整段抹掉。更麻烦的是 tsconfig.json` 这类配置,类型提示全靠编辑器推断,写出的预置答案和真实 schema 是脱节的。
核心能力
技能基于 pkg-types,把清单读写封装成带类型的操作,关键步骤:
- 读取:从给定目录向上查找最近的清单,返回带类型的对象,
name、version、scripts都有补全提示。 - 定位:严格走向上查找最近清单,不做当前目录硬读,避免读到嵌套子包的清单。
- 修改:只声明要改的字段,例如
scripts["build"] = "tsc -p tsconfig.json",其余原样保留。 - 回写:用
writePackageJSON写回,类型字段不丢。 - 自测:读一次拿到
name,回写后再确认scripts仍然存在。
PackageJson 与 TSConfig 的类型提示负责字段级校验,跳步或拼错键名在编码阶段就能发现,而不是等脚手架跑完才暴露。
适用边界
- 它是清单读写工具,不做 npm publish,也不做版本号 bump 之类的中台逻辑。
- 避免 ``
fs.readFileSync`+any` 这类无类型裸改,字段漂移会一路带到产物里。 - 不要把用户未提交的
package.json大段内容静默覆盖,字段级写回更可控。 - 实现要点处标注 小四原创,便于追溯改造位置。
使用场景
- 写 CLI 初始化模板时,从当前目录向上找到最近的 package.json,把 name 和 scripts 按模板重写
- 生成项目脚手架时,读取已有的 tsconfig.json,保留用户自定义字段,只改 compilerOptions
- 发布前检查脚本里,读出 package.json 的 scripts 字段,校验关键命令是否存在再决定是否放行
- 多包仓库批量改造时,逐层定位各子包的清单,更新构建脚本而不影响根目录文件
适合人员
- 独立开发者:写命令行工具时需要安全读取和修改用户项目的 package.json,不想依赖运行时猜字段
- 脚手架作者:生成模板后要回写项目元信息,希望字段有类型提示避免拼错键名
- 内部平台工程师:做发布前校验脚本,需要类型化的清单结构做条件判断
- Node 库维护者:为多包仓库批量更新脚本,担心手动改 JSON 丢掉已有字段