# Scriptify - AI 驱动的剧本创作工具

> 专注剧本创作阶段的AI辅助工具

**核心价值**: 帮助创作者从零写好剧本、小说改编剧本、漫剧快速创作

## ⚠️ 产品边界

**Scriptify 专注于剧本创作**,不涉及分镜、制作、拍摄等后期环节。

✅ **做什么**:
- 原创剧本创作 (教练/快速/混合模式)
- 小说改编剧本
- 剧本质量评估与优化
- 短剧/短视频剧本规范化

❌ **不做什么**:
- 分镜脚本设计
- 视觉资产生成
- 动态制作和剪辑
- 配音和视频渲染

💡 **如需完整制作流程**: 查看 [生态系统文档](./docs/ecosystem.md)

---

## 🎯 核心功能

### 1. 原创剧本创作
- **教练模式**: AI 引导你思考,100%原创
- **快速模式**: AI 生成初稿,快速迭代
- **混合模式**: AI 提供框架,你填充细节

### 2. 小说改编剧本
- 智能分析小说结构
- 自动提炼核心情节
- 内心戏外化转换
- 篇幅智能压缩

### 3. 漫剧创作
- **选题检查**: 五大核心标准评估,0-100分量化评分
- **快速改编**: 5步改编法,1-2分钟黄金结构
- **质量保障**: 自动化检查6大维度,具体改进建议
- **专项润色**: 去AI味、补细节、强化钩子
- **4种风格**: 沙雕/热血/甜宠/悬疑

### 4. 短剧/短视频优化
- 标准剧本格式输出
- 专业术语规范化

---

## 📦 安装

```bash
# 全局安装
npm install -g ai-scriptify

# 或本地开发
git clone https://github.com/wordflowlab/scriptify.git
cd scriptify
npm install
npm run build
```

---

## 🚀 快速开始

### 1. 初始化剧本项目

```bash
# 交互式创建项目,会引导选择 AI 助手、剧本类型等
scriptify init "我的第一部剧本"
cd "我的第一部剧本"
```

### 2. 开始创作

#### 原创剧本流程

**完整创作流程**:
```bash
scriptify /spec        # 1. 定义剧本规格(类型/时长/题材)
scriptify /idea        # 2. 构思故事创意(主角/目标/冲突)
scriptify /outline     # 3. 构建故事大纲(三幕结构)
scriptify /characters  # 4. 设计人物角色
scriptify /scene       # 5. 规划场次大纲
scriptify /script      # 6. 编写完整剧本
scriptify /polish      # 7. 润色优化剧本
scriptify /export      # 8. 导出成品
```

**三种创作模式**:
- **教练模式**: AI引导思考,100%原创 (`/script --mode coach`)
- **快速模式**: AI生成初稿,快速迭代 (`/script --mode express`)
- **混合模式**: AI提供框架,填充细节 (`/script --mode hybrid`)

#### 漫剧创作流程

**完整漫剧创作流程**:
```bash
scriptify /import                  # 1. 导入小说(自动评估适配度)
scriptify /select-novel            # 2. 选题检查(五大核心标准,0-100分)
scriptify /adapt-comic --style 沙雕 --episodes 60 --auto  # 3. 快速改编
scriptify /quality-check-comic --all  # 4. 批量质量检查
scriptify /polish --focus comic    # 5. 专项润色(去AI味)
scriptify /export                  # 6. 导出成品
```

**支持的漫剧风格**:
- 沙雕: 搞笑搞怪,神转折
- 热血: 燃点密集,逆袭爽感
- 甜宠: 恋爱甜度,心动瞬间
- 悬疑: 反转钩子,追剧欲望

**核心特色**:
- 1-2分钟黄金结构(前10秒抛冲突,后10-20秒留钩子)
- 5步改编法(拆书→细纲→改写→润色→调整)
- 6大维度质量检查(时长/对白/开篇/钩子/禁止内容/口语化)

---

## 📚 完整命令列表

### 项目管理 (5个)
- `/new` - 创建新项目
- `/open` - 打开项目
- `/list` - 列出所有项目
- `/save` - 保存项目
- `/export` - 导出剧本

### 原创剧本 (8个)
- `/spec` - 定义剧本规格
- `/idea` - 故事构思
- `/outline` - 故事大纲
- `/characters` - 人物设定
- `/scene` - 分场大纲
- `/script` - 剧本生成
- `/fill` - 填充混合模式框架
- `/polish` - 润色剧本

### 小说改编 (7个)
- `/import` - 导入小说(支持漫剧分析)
- `/analyze` - 结构分析
- `/extract` - 提炼情节
- `/compress` - 篇幅压缩
- `/visualize` - 视觉化转换
- `/externalize` - 内心戏外化
- `/script` - 生成剧本

### 漫剧创作 (3个)
- `/select-novel` - 漫剧选题检查(五大核心标准,0-100分评分)
- `/adapt-comic` - 漫剧改编(5步改编法,4种风格)
- `/quality-check-comic` - 漫剧质量检查(6大维度自动化评分)


---

## 🏗 架构设计

Scriptify 基于三层架构:

```
Markdown指令层 (templates/commands/*.md)
  → 定义检查标准和工作流程原则
  → 不包含硬编码对话

AI执行层
  → 灵活理解和执行
  → 根据上下文生成个性化反馈

Bash脚本层 (scripts/bash/*.sh)
  → 文件操作和项目管理
  → 输出JSON供AI使用
```

详见: `docs/scriptify/架构说明-Slash-Command设计.md`

---

## 📖 文档导航

### 🚀 快速开始
- **[QUICKSTART.md](./QUICKSTART.md)** - 5分钟快速入门 ⭐ 新手必读
- **[STATUS.md](./STATUS.md)** - 项目当前状态
- **[剧本格式快速参考](./docs/info/剧本格式快速参考.md)** - 日常创作速查 ⭐

### 📚 学习资源
- **[RESOURCES.md](./RESOURCES.md)** - 完整学习资源导航 ⭐ 推荐收藏
- **[短剧剧本写作完全指南](./docs/info/短剧剧本写作完全指南.md)** - 系统化教程
- **[短剧转动态漫SOP](./docs/info/短剧转动态漫SOP完整流程.md)** - 完整生产流程参考

### 🌐 生态系统
- **[生态系统文档](./docs/ecosystem.md)** - 从剧本到成片的完整生态 ⭐
- **[Scriptify产品文档](./docs/scriptify/)** - 当前产品PRD (v0.5.0)
- **[未来产品规划](./docs/roadmap/)** - Storyboardify等规划

### 🔧 技术文档
- **[架构说明](./docs/scriptify/架构说明-Slash-Command设计.md)** ⭐ 理解设计必读
- **[项目完成报告](./docs/FINAL_REPORT.md)** - v0.1.0完整总结
- **[验收清单](./docs/ACCEPTANCE_CHECKLIST.md)** - 功能验收
- [PROJECT_SUMMARY.md](./PROJECT_SUMMARY.md) - 完整项目总结
- [IMPLEMENTATION_STATUS.md](./IMPLEMENTATION_STATUS.md) - 实施进度
- [CLAUDE.md](./CLAUDE.md) - 开发指导原则
- [docs/README.md](./docs/README.md) - 文档导航中心

---

## 🛣 开发路线图

- ✅ Phase 1: 原创剧本创作(三模式系统)
- ✅ Phase 2: 小说改编剧本
- ✅ Phase 3: 漫剧创作支持
- 📋 Phase 4: Web UI版本
- 📋 Phase 5: 协作功能

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request!

---

## 📄 License

MIT License

---

**更新日志**: 查看 [CHANGELOG.md](./CHANGELOG.md)