install

用途

install 用于从 robdmc/claude_tools 仓库中发现并安装 Claude 工具，工具类型包括技能（skills）、智能体（agents）和命令（commands）。它面向希望将仓库中的工具部署到全局或项目级 Claude 环境的用户。

主要能力

• 发现工具：运行 python {SKILL_DIR}/install.py --list 可列出仓库中的所有工具及其组件，包括带可选 scripts/、references/、assets/ 目录的技能定义、智能体定义 markdown 文件以及旧版命令 markdown 文件。
• 交互式安装向导：/install 命令启动交互式安装流程。/install list 则跳过交互，直接显示工具列表。
• 选择安装位置：可选择全局（~/.claude/，在所有项目中可用）或项目（.claude/，仅在当前项目中可用）。
• 选择安装模式：复制（复制文件，可移植、独立）或符号链接（链接到源，自动更新，需保持仓库可访问）。
• 选择工具：用户输入工具编号（如 "1,3,5" 或 "all"），系统解析编号并映射回工具名称。

使用方式

工作流程如下：

1. 运行发现脚本：python {SKILL_DIR}/install.py --list
2. 将工具以编号列表展示给用户，例如：
   • 1. brainstorm - skills + 3 agents
   • 1. duckdb_sql - skills with references
   • 1. implement - skills + task-worker agent
   • 1. presentation - skills with scripts/references
   • 1. scribe - skills with scripts/references
   • 1. viz - skills with scripts/references
3. 通过 AskUserQuestion 收集用户选择：目标位置、安装模式和要安装的工具编号。
4. 执行安装命令：python {SKILL_DIR}/install.py --install --target <global|project> --mode <copy|symlink> --tools <tool1,tool2,...>
5. 报告安装结果，说明各组件安装到的位置。

安装映射

• {tool}/skills/（整棵树）→ {target}/skills/{tool}/
• {tool}/agents/*.md → {target}/agents/（平铺）
• {tool}/commands/*.md → {target}/commands/（平铺）

适用场景

适用于需要从该仓库批量或选择性部署 Claude 技能、智能体与命令到全局或项目环境的用户，尤其是希望脚本化发现并安装这些工具的场景。

限制与注意事项

• 符号链接模式要求仓库保持可访问。
• 复制模式创建独立副本，不会自动更新。
• 已有安装会被替换，不做合并。
• 技能目录结构会被保留（SKILL.md、scripts/、references/、assets/）。