SuperAPI AI 工具集

setup-wizard

部署与运维

查看项目

更新于 10-15 21:55

技能介绍

用途:Setup Wizard 用于交互式配置 Assistant Skills 的共享 Python 环境。当用户要求设置 Assistant Skills、配置 venv、安装依赖或运行 assistant-skills-setup 时使用。

主要能力:该技能基于命令而非 Python 脚本,通过 /assistant-skills-setup 斜杠命令引导 Claude 使用 AskUserQuestion 逐步完成设置。它会配置共享 venv(~/.assistant-skills-venv/,存放所有插件的 Python 依赖)、配置文件(~/.assistant-skills/config.yaml,记录设置状态、已安装插件与依赖哈希)、以及 shell 函数(写入 ~/.bashrc 或 ~/.zshrc)。

使用方式:运行 /assistant-skills-setup 启动向导。设置完成后用 claude-as 代替 claude 运行,以启用 venv 依赖;该函数将 venv 加入 PATH 而不全局激活。向导还会读取各插件 plugin.json 中的 assistant_skills.env_vars,检查已设置的环境变量,并可选地向 shell RC 添加占位导出。当插件 requirements.txt 变化时,SessionStart 钩子检测哈希不匹配并自动运行 pip install -r requirements.txt --upgrade 并更新哈希。

适用场景:需要为多个 Assistant Skills 插件统一准备 Python 依赖与环境变量时。

限制与排错:若找不到 Python,macOS 可用 brew install python@3.11,Ubuntu/Debian 用 sudo apt install python3 python3-venv;venv 创建失败可先安装 python3-venv 或手动执行 python3 -m venv ~/.assistant-skills-venv;会话中找不到依赖需改用 claude-as 或手动 source ~/.assistant-skills-venv/bin/activate。重跑设置可先删除 ~/.assistant-skills 与 ~/.assistant-skills-venv 再执行 /assistant-skills-setup。