All skills
cat-xierluo avatar

/env-doctor

@d1fe353

本机开发环境与全局包的体检、账本与安装纪律,覆盖所有包管理器(npm/npx、nvm、pip/pipx、uv、brew、bun)与运行时环境面(~/.local/bin 垫片、PATH、python 解释器版图、LaunchAgents、cron、shell rc 漂移对照)。当用户问「node/python 为什么是这个版本」「npm/pip 全局包装到哪了」「环境怎么又乱了」「PATH/rc 被谁改了」「多了个 LaunchAgent」,或任何 agent 在执行 npm i -g / uv tool install / pipx install / brew install 等全局安装、修改 shell rc 文件、注册 LaunchAgent/cron、触碰 ~/.local/bin 符号链接、或在厂商应用(Hermes/Deck/Wukong 等)更新后复核环境之前,必须先读本 skill 并遵守其纪律。不要用于:单个项目内的 node_modules / venv 依赖管理、CI 环境、Linux 服务器初始化。仅 macOS。

  • 4 files
  • 22.5 KB
  • MIT
  • Updated 2 days ago
  • GitHub

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/env-doctor

This session only. Nothing lands on disk.

referencesknown-baseline.md

≈939 tokens on demand. Your agent reads this file only when SKILL.md points to it.

已知基线(2026-09-30 建立,同日随 v0.2.0 扩域)

机器运行时环境的权威快照。基线漂移时更新本文件并记账(env-doctor.sh record)。

node 分布(共 4 个,各有归属)

node 路径 归属 纪律
v24.11.0 ~/.nvm/versions/node/v24.11.0 用户默认(nvm default = lts/krypton) npm i -g 唯一合法落点
v22.22.3 ~/.hermes/node Hermes 自管 勿手动升级/删除其下全局包(codex/codebuddy/agently/lark/cubox/docx 等 8 个)
v25.2.1 /opt/homebrew/Cellar/node/ brew brew 自管
v20.12.0 /usr/local/bin/node 2024-03 pkg 安装残留(root 所有,192M) PATH 最末兜底,无害,清掉需 sudo

用户 shell 的 node/npm/npx 一律经 ~/.local/bin 垫片解析到 nvm v24——包括 launchd 拉起的干净 shell(只有 .zshenv 生效,PATH 无 brew/nvm)。

各包管理器落点(2026-09-30 普查)

管理器 现状 纪律
npm 全局装 nvm v24 prefix(claude-code/gemini-cli/iflow/codex/qwen-code 等);~/.hermes/node 下另有 8 包属 Hermes 装前 npm prefix -g 核对是 nvm
uv tools:blender-mcp、browser-use、kimi-cli、makelive;~/.local/share/uv/python/ 多套解释器;~/.local/bin/python3.11/3.12 指向 uv python Python CLI 首选通道
pipx 与 uv tools 同一批 4 个(双通道可见) 二选一即可,勿重复装
pip --user ~/Library/Python/3.11/ 一批库 原则上不手装 CLI,只放库
brew 65 leaves、108 过时(2026-09-29 口径) 升级需用户点名
bun 全局仅 ccusage + 用户自写 cc-buddy-roller/show-tokens;缓存 2G 已清 少用,装了记账

漂移基线(2026-09-30 立)

  • 基线文件 ~/.config/env-doctor/state:6 个 shell rc 文件的 SHA-256 + 30 个 LaunchAgents 名单,由 env-doctor.sh snapshot 生成。
  • 之后每次体检第 8 节自动对照;变更确认合法后重跑 snapshot 重立 + record 记账。
  • 本基线是「谁动了我的环境」的裁判:Deck/Hermes 式 rc 注入、新增 LaunchAgent 都会 在下一次体检现形。

垫片层

  • ~/.local/bin 是全机唯一垫片层(约 47 项:uv tools、claude、zcode、Hermes CLI 等)。
  • node/npm/npx → ~/.nvm/versions/node/v24.11.0/bin/(2026-09-30 由 Hermes 的 ~/.hermes/node 重指向而来)。
  • 回滚:ln -sfn ~/.hermes/node/bin/<t> ~/.local/bin/<t>(t=node/npm/npx)。
  • 复发条件:① 用户换 nvm 默认/删 v24 时须重指;② Hermes 升级重装可能把链接抢回 自家 node——env-doctor.sh 报 🚨 即此因。
  • 已知死链(2026-09-30 体检发现,待用户裁决):openclaw(ClawX 卸载)、 python3.10(Eigent 更新)、qoderclicn(QoderWork CN 更新)。

Hermes 自管边界(勿动清单)

  • ~/.hermes(12G):自带两套 node(node/ v22.22.3 + tools/node-26.7.0)、npm、 python 3.14、ripgrep、ffmpeg、agent-browser;gateway 走绝对路径,不依赖任何垫片。
  • rc 注入:.zshenv / .zprofile / .profile 各有一行 export PATH="$HOME/.local/bin:$PATH"(注释标 Hermes Agent)——合法存在,勿清理。
  • .zshrc 另有 # Added by Deck.app 等其他应用的注入,同属地质层,改动前记账。

事件史(摘要,明细看账本 ~/.config/env-ledger.md)

  • 2026-09-29:全机普查 + 清理 ~6.7G(删 ~/Skill_Seekers、nvm 卸 v18.20.8/v22.17.0、 清 npm 缓存 3.2G 与 bun 缓存 2G)。
  • 2026-09-30:node 垫片重指向 nvm v24(见上);创建本 skill(v0.1.0 时名 env-hygiene, 同日更名 env-doctor 并扩域至全部包管理器)。

Source: SKILL.md on GitHub

No third-party reports yet.

Signed by skilld at d1fe353. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 days ago
homepage
https://github.com/cat-xierluo/legal-skills
author
杨卫薪律师(微信ywxlaw)
version
0.3.0

README badge

README badge for cat-xierluo/legal-skills/env-doctor