Script Weaver — AI skill for Claude Code

Script-Weaver

**Agent-native 剧本 + 分镜生成系统** — 随用户成长的 AI 创作管线

从一个故事想法出发，自动生成完整剧本和专业分镜脚本，可直接用于下游视频生成工具（Seiko/Runway/Kling 等）。

核心特性

• Agent-Native 架构: 9 个专业 Agent（创意细化、大纲构建、角色设计、场景设计、美术指导、剧本写作、分镜拆解、质量审查、编排调度），每个 Agent 拥有自主 tool-use 循环
• 多 LLM 支持: 统一接口支持 Anthropic Claude / OpenAI GPT / DeepSeek / GLM / Qwen / Ollama 等任意 OpenAI 兼容服务
• Skill 插件系统: 支持用户自定义 Skills（YAML / JSON / Claude Code .md 格式），可在每个 Pipeline 阶段注入，支持动态激活/禁用/排序
• Grows With User: 三层成长机制 — 项目级经验记忆 + 跨项目用户画像 + Skill 自进化
• 下游就绪: 分镜输出包含逐镜头的 image/video prompt，可直接喂给 AI 视频生成工具
• 多格式导出: JSON / Fountain (Final Draft 兼容) / VideoGen CSV

快速开始

安装

cd script-weaver
pip install -e ".[dev]"

配置

cp .env.example .env
# 编辑 .env，填入你的 LLM API Key

支持的 Provider:

环境变量	说明
SCRIPTWEAVER_LLM_PROVIDER	anthropic / openai / deepseek / glm / qwen / openai_compatible
SCRIPTWEAVER_LLM_MODEL	模型名称 (默认: claude-sonnet-4-20250514)
SCRIPTWEAVER_ANTHROPIC_API_KEY	Anthropic API Key
SCRIPTWEAVER_OPENAI_API_KEY	OpenAI / DeepSeek / 兼容服务 Key
SCRIPTWEAVER_GLM_API_KEY	智谱 GLM API Key
SCRIPTWEAVER_QWEN_API_KEY	通义千问 API Key
SCRIPTWEAVER_OPENAI_BASE_URL	OpenAI 兼容端点 (Ollama/vLLM 等)

运行

# 从一个想法生成完整剧本+分镜
python -m script_weaver generate "一个穿越时空的古装爱情故事，女主角能看见别人的命运线"

# 指定标题和输出目录
python -m script_weaver generate "你的想法" --title "我的剧本" --output-dir ./output

# 管理 Skills
python -m script_weaver skills list                    # 列出所有可用 Skills
python -m script_weaver skills list --stage structuring   # 按阶段筛选
python -m script_weaver skills install ./my-skill.yaml    # 安装新 Skill
python -m script_weaver skills activate save-the-cat --stage structuring  # 激活 Skill

# 查看用户画像（学习到的偏好）
python -m script_weaver profile show

系统架构

用户输入 (idea/大纲/任何格式)
       │
       ▼
┌─────────────┐
│ Orchestrator │ ← 编排器：路由请求到正确的 Agent
└──────┬──────┘
       │
       ├──────────────┐
       ▼