## 工作流程 ### 第 1 步：获取 MCP 配置 * **方法A** : 用户在对话中粘贴配置 → 直接使用 * **方法 B** : 用户提供的配置文件路径 → 使用该路径 * 如果没有提供，询问：“请提供MCP配置（直接粘贴JSON或提供文件路径）” **支持的格式：** * Stdio MCP（基于 npx） * HTTP MCP * 直接格式（没有 mcpServers 包装器） ### 第 2 步：生成技能 **确定输出位置：** * 询问技能名称（或从配置的“名称”字段中提取） * 输出目录：`./skills/<技能名称>/` **执行转换：** # 如果配置在对话中（方法 A）：猫 > /tmp/mcp-config.json << 'EOF' <配置内容> EOF npx -y mcp-to-skill 生成 \ --mcp-config /tmp/mcp-config.json \ --output-dir ./skills/<技能名称> # 如果配置是文件路径（方法B）： npx -y mcp-to-skill 生成 \ --mcp-config <配置文件路径> \ --output-dir ./skills/<技能名称> **生成的结构：** ./skills/<技能名称>/ ├── SKILL.md # 说明（~100 个代币） └── mcp-config.json # MCP 服务器配置 ### 步骤 3：添加脚本支持（必需）生成的技能需要环境变量处理程序脚本： # 将辅助脚本复制到生成的技能中 mkdir -p ./skills/<技能名称>/scripts cp $(dirname $0)/scripts/exec-with-env.sh ./skills/<技能名称>/scripts/ chmod +x ./skills/<技能名称>/scripts/exec-with-env.sh **结果结构：** ./skills/<技能名称>/ ├── 技能.md ├── mcp-config.json └── 脚本/ └── exec-with-env.sh # 环境变量处理程序 ### 步骤 4：修复 SKILL.md 执行指令（关键） **生成的 SKILL.md 包含错误的指令。你必须修复它们：** ❌ **删除所有说明，例如：** npx -y mcp-to-skill exec --config $SKILL_DIR/mcp-config.json --call '{...}' ✅ **替换为基于脚本的执行：** $SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json <工具名称> '{"param": "value"}' **生成的 SKILL.md 所需的更改：** 1. **添加命令/用法部分**显示脚本用法： ## 命令 **执行工具：** ````bash $SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json tool_name '{"param": "value"}' **示例：** # 工具 1 的示例 $SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json tool1 '{"query": "hello"}' # 工具2的示例 $SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json tool2 '{"input": "test"}' 2. **删除任何“npx -y mcp-to-skill exec”引用** 3. **更新描述**以提及环境变量支持 4. **添加执行策略部分**（在使用模式或错误处理之前）： ## 执行策略 **重要：直接执行，不要事先询问** 使用此技能时，**直接执行命令**，无需要求用户确认环境变量是否设置。 - 环境变量状态在执行时确定 - 如果执行失败，错误消息将明确指示缺少配置 - 然后才通知用户需要配置什么 - 遵循“快速失败”原则，避免不必要的交互 ❌ **不要这样做：** - “请确认您已设置 API_KEY 环境变量” - “执行之前，请确保您已配置...” ✅ **这样做：** - 直接执行命令 - 如果失败，根据错误信息通知用户 ### 第 5 步：测试技能创建用于测试的符号链接： ln -s ../../skills/<技能名称> .agents/skills/<技能名称> 或者复制到全局技能目录： cp -r ./skills/<技能名称> ~/.config/skills/ ## 脚本 ### exec-with-env.sh 具有环境变量支持的通用 MCP 技能执行器。 **为什么需要：** MCP 配置通常包含 API 密钥的“${VAR}”语法。 “mcp-to-skill”工具无法解决这些问题。该脚本在执行前生成一个包含已解析值的临时配置。 **位置：** `scripts/exec-with-env.sh` **用途：** script/exec-with-env.sh <工具名称> [arguments-json] **示例：** # 基本用法脚本/exec-with-env.sh ./my-skill/mcp-config.json web_search \ '{“查询”：“你好世界”}' # 使用默认值进行配置： # "API_HOST": "${API_HOST:-https://api.example.com}" 脚本/exec-with-env.sh ./mcp-config.json tool_name '{"input": "test"}' **mcp-config.json 中支持的语法：** * `$VAR` \- 直接替换 * `${VAR}` \- 大括号格式 * `${VAR:-default}` \- 使用默认值 **错误处理：** * 如果环境变量未设置且没有默认值则退出 * 执行前验证生成的 JSON ## 快速参考任务|命令 ---|--- 生成技能 | `npx -y mcp-to-skill 生成 --mcp-config <文件> --output-dir ./skills/<名称>` 添加脚本 | `cp 脚本/exec-with-env.sh ./skills/<名称>/scripts/` 执行工具 | `$SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json <工具> '{"param": "val"}'` ## 参考 * 原始项目：

Mcp 技能

包含技能