# Text Generate

> 使用 meitu-cli 调用独立 LLM 从零生成文本/文案/分镜脚本/视频提示词。当用户提到写文案、润色、改写、广告语、产品描述、社交媒体文案、文章、分镜脚本、storyboard、提示词优化时触发。上下文已有完整内容时禁用，应改用 write_file。

- Skill: `meitu/text-generate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add meitu/text-generate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/meitu/text-generate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: meitu (https://skillmd.com/u/meitu)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/meitu/text-generate

---


# Text Generate（文本生成）

## Overview

独立 LLM 深度创作工具，从零生成文案/脚本/分镜/视频提示词等纯文本内容。覆盖营销文案、产品描述、社交媒体文案、文章/博客、广告语、内容润色改写、多语言文案、图片/视频参考文案、视频分镜规划、视频提示词优化。⚠️ 上下文中已有完整内容时禁止调用，应改用 `write_file` 直接落盘；仅当上下文只有方向性需求、需要 LLM 独立深度思考时使用。不处理：视频/图片/音频/代码/表格生成。

## API Mapping

| 场景 | 后端 API | 底层模型 |
|------|---------|---------|
| 通用文本 / 分镜脚本生成 | `text_generate` | `qwen3.6-vl-plus`（scone）/ `gemini-3.1-pro-preview`（pretzel_pro）|

model 映射：

- `auto`（默认）/ 不传 → 按路由规则决策
- `scone` → `qwen3.6-vl-plus`（日常主力）
- `pretzel_pro` → `gemini-3.1-pro-preview`（视频理解最强，长上下文）
- 双模型互为兜底

## Dependencies

- **meitu-cli**: `>=2.0.6`
- **凭证**：CONFIG AKSK → `meitu tools update`；EXEC AKSK → 跑命令（见根 `CONFIG.md`）
- **环境变量**：`MEITU_OPENAPI_TOOL_TASK_MODE=command`

## Core Workflow

```
Preflight → Execute → Deliver
```

### Preflight

1. `meitu --version` ≥ 2.0.6
2. `meitu auth verify --json`
3. 确认 registry 含 `text-generate`
4. 解析 output_dir：`openclaw.yaml` → `./output/`；else → `~/.openclaw/workspace/visual/output/text-generate/`

### Execute

**触发信号 / 路由规则**

| 场景 | 判定维度 | 路由 |
|------|---------|------|
| 有视频参考 | `video_list` 非空 | 锁定 `gemini-3.1-pro-preview`（pretzel_pro）|
| 高难度场景 | 调用方显式传 `model=pretzel_pro` | `gemini-3.1-pro-preview` |
| 日常场景 | `auto` / 未传 model | `qwen3.6-vl-plus`（scone，日常默认）|

高难度判定标准（由调用方判断）：视频输入、长上下文 >2000 字、复杂推理（多步逻辑/对比分析/因果论证）、专业领域（法律/医学/金融/学术）、多约束创作（≥3 创作约束同时）、跨语言深度适配、多镜头分镜脚本规划。

**参数定义**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `summary` | STRING | 是 | -- | 文案/分镜需求描述。应含文案类型、目标受众、核心目标、风格；分镜场景需含主题、镜头数、场景描述。缺失 → 追问 |
| `language` | STRING | 是 | 简体中文 | 输出语言，跟用户输入语言一致 |
| `model` | STRING | 否 | 按路由规则 | 可选 `scone` / `pretzel_pro` |
| `prompt_name` | STRING | 否 | auto | 提示词优化模板名称 |
| `image_list` | ARRAY | 否 | -- | 参考图片 URL 列表，无则不传 |
| `video_list` | ARRAY | 否 | -- | 参考视频 URL 列表，无则不传 |
| `output_file` | STRING | 否 | -- | 输出文件 URL 地址 |

**工具调用**

日常文案：
```bash
meitu text-generate \
  --skill_name skill_text-generate \
  --summary "{需求描述}" \
  --language "简体中文" \
  --json
```

高难度 / 视频分镜：
```bash
meitu text-generate \
  --skill_name skill_text-generate \
  --summary "{分镜需求}" \
  --language "简体中文" \
  --model pretzel_pro \
  --video_list "{video_url}" \
  --json
```

英文文案：
```bash
meitu text-generate \
  --skill_name skill_text-generate \
  --summary "Write a product description for ..." \
  --language "English" \
  --json
```

**错误降级**

| 场景 | 处理方式 |
|------|---------|
| `summary` 缺失 | 提示"请描述你想要的内容" |
| `summary` < 5 字符 | 提示补充文案类型/目标受众/风格 |
| `language` 未指定 | 按用户输入语言自动判断，默认简体中文 |
| `image_list` 全部无效 | 静默过滤，按纯文本路径选模型 |
| 默认模型调用失败 | 切换另一模型重试 |
| 双模型均失败 | 返回错误信息 |
| API 超时 | 切换另一模型重试 → 均失败返回错误 |
| 内容合规拦截 | 直接返回合规提示 |

冲突规则：
- 用户同时要分镜 + 直接出视频 → 本工具仅生成分镜脚本，视频生成由上层工作流串联 `text-to-video`
- 用户要文案 + 配图 → 文案走本工具，配图需上层编排 `text-to-image`
- 用户指定模型名 → 尊重指定，跳过自动路由

### Deliver

解析 `--json`：
- `ok: true` → 从返回结构中提取文本内容
- 若调用时显式指定 `output_file`，则按该路径写入
- 否则将文本写入 `{output_dir}/{YYYY-MM-DD}_{descriptive-name}.md`

默认落盘：`{output_dir}/{YYYY-MM-DD}_{descriptive-name}.md`

## Output

- **格式**: 纯文本 / Markdown（`.md` / `.txt`）
- **命名**: `{YYYY-MM-DD}_{descriptive-name}.md`
- **位置**: 项目 → `./output/`；一次性 → `~/.openclaw/workspace/visual/output/text-generate/`

## 基线 Task ID

见根目录 `references/task-id-baseline.md` 中 `text-generate` 条目。