用途：这是机器级安装检查，每台机器运行一次，而非按项目运行。用于验证已安装插件的 agent 及其预加载技能能否解析，提供一个可选的用户级设置，并报告一行用户可自行添加的 dotfiles 配置。技能幂等，可安全重复运行；先读取再写入，且每次写入前都先询问用户。
主要能力：
- 验证安装：agent 的 skills: frontmatter 会预加载指引，若预加载无法解析到真实技能，或指向 disable-model-invocation: true 的技能，只会向调试日志输出警告，agent 仍会启动但指引不会到达。需同时检查 agents/（由 Claude Code 自动发现，注册为插件作用域，仅响应 workflows:<name>）与 user-agents/（不自动发现，需通过符号链接进入 ~/.claude/agents/ 才注册为裸名）。未链接的 agent 修复方式是符号链接而非复制。
- 可选设置用户级 plansDirectory：这是偏好而非修复，未设置时回退到 .claude/plans。仅在用户明确选择后合并该键，且先解析文件，解析失败则拒绝覆盖，并原子写入。
- 检查主线程守卫允许列表（仅报告）：确认 workflows:* 仍被允许且拒绝消息仍指向 farm.sh。不要编辑该文件，若缺失则展示一行改动让用户自行应用。
- 报告：从磁盘读取实际状态，逐项列出检查结果，明确说明被跳过的步骤，并提示用户设置在新会话生效。
使用方式：运行 LINES=1000 COLUMNS=250 upmd --ci --all ${CLAUDE_SKILL_DIR}/references/install-check.md（若无 upmd 则按顺序运行该文件的 bash 块），读取其 agents-listed 与 preloads 输出。若插件源码检出即当前项目，权威检查为 bun tests/agent-contract.test.mjs。
限制：不配置任何项目，不触碰 .claude-workflows.json，不设置项目级 persona，不在项目目录下写入任何内容。未解析的预加载应通过重装或更新插件修复，而非编辑 ~/.claude/skills/workflows/ 下的已安装副本。用户设置仅在会话启动时读取一次，任何写入需新会话生效。禁止在未解析文件的情况下写入设置，禁止硬编码 agent 名单，禁止编辑 ~/.claude/hooks/main-thread-guard.sh。