giasip-dispatch

Files (1)

• SKILL.md

SKILL.md (first lines)

> ✦ A **GiaSip** skill · part of the `giasip` toolkit · github.com/GiaSip

# /dispatch — 多模型调用器

把一个任务或 prompt 派发给其他 AI 模型执行，取回结果。这个 skill **只提供调用能力**——选哪个模型、单派还是多派，由你（或当前的 Claude）根据任务临场判断，本 skill 不内置选型偏好。

## 脚本目录（Script Directory）

**重要**：所有脚本都在**本 skill 目录**下的 `scripts/` 子目录里。

**Agent 准备 —— 跑下面任何命令前先做一次**：确定包含本 `SKILL.md` 的目录的绝对路径，export 为 `BASE_DIR`：

```bash
# 全局安装（最常见）；作为 plugin 安装时改用 plugin 缓存路径
export BASE_DIR="$HOME/.claude/skills/giasip-dispatch"
```

下文所有命令都用 `$BASE_DIR/scripts/<脚本名>` 引用脚本。`BASE_DIR` 是**你自己**在 session 里设的 shell 变量——运行时**不存在** `CLAUDE_SKILL_DIR` 这个注入变量，所以必须先设 `BASE_DIR`，否则脚本路径会解析为空。

## 两类调用通道

| 通道 | 模型 | 前提 |
|------|------|------|
| **API 直调**（curl，最快） | DeepSeek / Qwen / GLM / 豆包 / MiniMax | 只需在 `~/.config/ai-keys/` 放对应 `.env`（含 API key） |
| **CLI 调用** | Codex / Gemini / Kimi | 需本地安装并登录对应 CLI |
| **内部 SubAgent** | Claude Haiku / Sonnet | Claude Code 自带，无需外部依赖 |

> 纯思考/分析类任务（不需要读文件、执行命令、改代码）优先走 **API 直调**——比 CLI 快约 10 倍。需要 Agent 能力（操作文件系统、执行命令、改代码）才走 CLI。

---

## 通用纪律（所有 CLI 调用必读）

1. **用 heredoc 传 prompt** —— 避免引号 / 特殊字符问题。
2. **所有 CLI 调用加 `</dev/null`** —— Claude Code 的 Bash 环境中 stdin 是永不关闭的管道，不加会导致 CLI 卡死在等待 stdin。
3. **构造 prompt 时**：简洁明确；不要塞入 Claude Code 专有概念（skills / hooks / SubAgent）；中文任务用中文 prompt，英文任务用英文 prompt；涉及具体项目时补必要上下文。

---

## 复杂度路由

根据任务性质自动选择派遣策略：

```
视觉任务？（PDF 图册 / 扫描件 / 截图 / 图片解析）
├── 是 → [Gemini CLI] — 原生 PDF + 图片视觉解析
│   触发：用户提供了图片/PDF 路径 + 任务涉及"读取"内容；
│   或 markitdown 输出为空/异常小
│   → 不要先试 markitdown——直接路由 Gemini
│
├── 纯思考/分析（商业分析、战略、文本理解、翻译）
│   → [API 直调] — 不需要 Agent 能力，直接 curl
│   快 10 倍；支持没有 CLI 的模型（DeepSeek/Qwen/GLM 等）
│
├── 简单 + 可逆（装包、格式化、搜索、生成模板）
│   → [单派] — 优先 Claude SubAgent (Haiku) 追求速度
│   只有需要中文原生或特定 AI 能力时才走外部 CLI
│
├── 代码执行（修 bug、写测试、小重构、生成代码文件）
│   → [Codex 写模式] — sandbox=full，Codex 直接改代码
│   条件：任务明确、在 git 管理项目中、影响可控
│   执行后必须提醒用户 `git diff`
│
├── 中等复杂（功能开发、文档分析、代码分析）
│   → [单派] — 发给最合适的 AI
│
├── 复杂 + 不可逆（架构设计、技术选型、大重构）
│   → [多派] — 自动升级，发给 2-3 个 AI 对比
│
└── 用户指定（"用 Kimi 跑一下"）
    → [直接指派] — 发给指定 AI，跳过匹配
```

**多派触发条件**（满足任一自动升级）：
- 用户说"重要"、"关键决策"、"不能出错"
- 任务涉及不可逆操作（数据库迁移、生产部署）
- 任务是技术选型或架构设计
- 预估影响面 > 10 文件或 3 模块
- 中文商业/战略分析任务（默认三路并行）

→ 多派阵容推荐见 `references/model-roster.md`。

---

## 调用方式

### API 直调（DeepSeek / Qwen / GLM / 豆包 / MiniMax）

不需要 Agent 能力的纯分析任务，直接调 API。通用脚本：

```bash
$BASE_DIR/scripts/api-dispatch.sh --model <model> "$(cat <<'EOF'
prompt 内容
EOF
)"
```

长文本用 stdin：

```bash
echo "长文本内容" | $BASE_DIR/scripts/api-dispatch.sh --model <model> --stdin
```

支持的模型 — 完整阵容及各模型强项见 `references/model-roster.md`。

| 参数 | 模型 | Key 文件 | 上下文 |
|------|------|---------|--------|
| `deepseek` | DeepSeek V4-Pro（思考模式默认开） | `deepseek.env` | 1M |
| `qwen` | 通义千问 Qwen3.6 Plus | `dashscope.env` | 1M |
| `glm` | 智谱 GLM-5.1（旗舰） | `zai.env` | 200K |
| `doubao` | 字节豆包 Seed-2.0 Pro | `volcengine.env` | 256K |
| `minimax` | MiniMax M2.7 | `minimax.env` | — |

> 模型名随版本更新——调用前可查各家最新文档。

### Codex CLI（OpenAI）— 通过 App Server 协议直连，无冷启动

只读模式（分析 / review / 调研）：

From GiaSip/giasip-skills, MIT.

More from GiaSip/giasip-skills