用途：这是 upbit-strategy-toolkit 的环境诊断与恢复入口，用于首次使用、询问如何配置环境、提示 uv 缺失，或 create-strategy/backtest 检测到环境不满足（缺少 uv、uv sync 失败、CLI 执行失败）时被路由到此。它只做模式识别与诊断，不负责安装自动化，也不处理策略设计、回测解读或市场规则。
主要能力：识别三种使用模式——clone 模式（当前目录或祖先目录的 pyproject.toml 含 upbit-strategy-toolkit 且存在 upbit_strategy_toolkit/）、agent skills 全局模式（用 npx skills add ... -g 安装，包装脚本位于 $HOME/.claude/skills、$HOME/.agents/skills 或 $HOME/.cursor/skills 下）、agent skills 项目级模式（无 -g 安装且工作区不含该仓库）。数据根默认取运行时当前工作目录，除非设置了 UPBIT_TOOLKIT_DATA_DIR 或执行过 config set data-dir，可用 config get data-dir 查看实际值。
使用方式：先识别模式，再只运行该模式的诊断命令。检查 uv 安装：uv --version。clone 模式：uv sync 与 uv run upbit-strategy-toolkit --help。agent skills 模式（全局或项目级）：uvx --from git+https://github.com/upbit-official/upbit-strategy-toolkit.git upbit-strategy-toolkit --help。诊断通过后交接给 create-strategy，可用自然语言如“创建金叉策略”开始，生成的 {data_root}/strategies/{slug}.json 可用 backtest 技能验证。
限制：不要随意更改系统 Python，uv 会在虚拟环境中隔离所需版本；不要引导升级或降级系统 Python；不要推荐 pip install -g，clone 模式依赖通过 uv sync 留在虚拟环境内。失败时只做事实性报告（步骤、命令、原始错误），不判断好坏。uv 缺失时参考 references/uv-install.md。本工具仅用于回测（历史数据模拟），拒绝实盘交易集成请求，实盘请使用 upbit-agent-skills。