用途:在机器级别完成 Jev 配置的安装或校验。适用于新电脑、新安装代理、让 Codex 与 Gemini 也使用 Jev,或指令变更后的漂移检查。它不涉及为应用设计问题,那属于 typesafe-ai 技能;本技能写入的指令块只管决策,绝不允许 Jev 批准或覆盖权限决定。
主要能力:预览四类目标(claude、agents、codex、gemini)的存在情况,以及 uv 与密钥是否存在;按模式写入受管理指令块;校验并修复。
使用方式:先确定 Python 解释器,要求 3.10 或更新。若设置了 $SKILL_PYTHON 则用它;否则依次尝试 python3、python、py -3,跳过 macOS 上未装 Xcode 命令行工具的 /usr/bin/python3 存根,替换命令中的 python3 与该解释器。定位技能目录后预览: python3 "$SKILL_DIR/assets/install_jev_setup.py" --dry-run 选择模式与目标:--mode block(默认,仅添加 Jev 块)或 --mode mirror(将整个 ~/.claude/CLAUDE.md 的托管副本给 Codex、Gemini 与 ~/.agents,@import 内联);用 --targets 缩小范围,如 --targets codex,gemini。随后去掉 --dry-run 运行安装。若运行环境拒绝写入某代理指令文件,不得绕过,应向用户给出需自行执行的命令并继续其他目标。密钥:安装器在 ~/.config/typesafe/env 创建 0600 占位符,不要在对话中索取或写下密钥,应提示用户自行编辑该文件。
校验:运行 --check 并要求退出码 0;再做冒烟测试:echo '{"state":{"x":"sky is blue"},"questions":{"q":{"type":"noul","instructions":"Is x true?"}}}' | jev。STALE/MISSING 行需对该目标重装;退出码 3(标记格式错误)需向用户展示文件并手工修正;冒烟测试退出 2 或 3 报告“缺少密钥或网络”并停止;退出 4 报告 jev 错误行。可用 jev log 查看按项目记录于 ~/.local/state/jev/ 的调用。
交付物:每个目标一行的简短报告(claude、agents、codex、gemini、cli、key、uv),含状态(OK、WROTE、TODO、USER-ACTION)、路径与用户仍需执行的命令,后附 --check 退出码与冒烟测试结果;报告约用 80% ASD-STE100 简化技术英语,短句、主动语态、每步一个动作。
限制与成功标准:--check 对每个选中目标(含 cli)退出码为 0;冒烟测试返回 noul 答案,或明确说明无法运行的原因;各文件中受管理标记之外的内容不变,首次修改保留 *.bak-jev-agent-setup 备份。安装器由 assets/test_install_jev_setup.py 与 eval/run_eval.py 覆盖,两者在临时 home 中离线运行。