---
name: project_management
description: 项目管理和内容组织的最佳实践，包括项目创建、资产管理和文本分析
---

# 项目管理技能

本技能提供项目管理、资产组织和内容分析的专业指导。

## 📚 相关资源

本 Skill 采用渐进式披露设计，额外资源按需读取：

- **reference.md** - 完整的 API 技术参考、资产类型规范、项目类型对比
- **templates/project_config.json** - 项目配置模板（动漫视频、写实视频、漫画项目）
- **examples/novel_to_project.md** - 小说转项目完整示例（自动提取角色、场景、章节）
- **scripts/validate_project.py** - 项目验证脚本（检查项目结构和资产完整性）

💡 使用 `read_file()` 读取这些文件获取详细信息

## 何时使用此技能

当你需要：
- 创建和管理视频/漫画项目
- 从小说文本提取角色和场景
- 组织和分类项目资产
- 将长文本分割成章节
- 管理项目元数据

## 可用工具

### 项目管理
- `list_projects` - 列出所有项目
- `get_project` - 获取项目详情
- `create_project` - 创建新项目

### 智能分析
- `create_project_from_novel` - 从小说文本创建项目
- `extract_assets` - 从文本提取角色、场景、道具
- `split_text_into_chapters` - 将长文本分割成章节

## 项目类型

### 视频项目 (video)
**适用场景**：
- 短视频制作
- 动画片段
- 广告视频
- 教程视频

**特点**：
- 以分镜为单位组织
- 支持时间轴管理
- 包含音频配置

## 工作流模式

### 模式 1: 手动创建项目
```
用户请求 → create_project(name, type, style) → 返回项目ID
```

**适用场景**：
- 从零开始的新项目
- 明确的项目需求
- 简单的项目结构

**示例**：
```python
create_project(
    name="我的第一个动画",
    project_type="video",
    style="anime",
    description="一个关于冒险的短片"
)
```

### 模式 2: 从小说创建项目（推荐）
```
用户提供小说文本 → create_project_from_novel → 自动提取资产 → 返回完整项目
```

**适用场景**：
- 小说改编视频/漫画
- 有完整剧本的项目
- 需要自动提取角色和场景

**流程**：
1. 分析文本内容
2. 提取角色（姓名、描述、特征）
3. 提取场景（地点、时间、氛围）
4. 提取道具（重要物品）
5. 分割章节/分镜
6. 创建项目结构

**示例**：
```python
create_project_from_novel(
    project_name="魔法学院",
    novel_text="在一个遥远的魔法世界...",
    style="anime"
)
```

### 模式 3: 分步骤创建项目
```
1. create_project → 获得项目ID
2. extract_assets(text) → 获得角色、场景列表
3. 手动添加资产到项目
4. split_text_into_chapters → 创建章节结构
```

**适用场景**：
- 需要精细控制的项目
- 复杂的项目结构
- 需要人工审核的内容

## 资产提取指南

### 角色提取 (Character)

**提取内容**：
- 姓名/称呼
- 外貌描述
- 性格特征
- 关键服装
- 重要道具

**示例输入**：
```
李明是一个17岁的高中生，戴着黑框眼镜，
总是穿着校服，性格内向但善良。
他的书包里总是装着一本魔法书。
```

**提取结果**：
```json
{
  "name": "李明",
  "type": "character",
  "description": "17岁高中生，戴黑框眼镜，性格内向善良",
  "visual_features": "黑框眼镜，校服",
  "props": ["魔法书"]
}
```

### 场景提取 (Scene)

**提取内容**：
- 地点名称
- 环境描述
- 时间（白天/夜晚）
- 氛围/情绪
- 关键元素

**示例输入**：
```
魔法学院的图书馆，古老的建筑，
高耸的书架，昏暗的烛光，
充满神秘的氛围。
```

**提取结果**：
```json
{
  "name": "魔法学院图书馆",
  "type": "scene",
  "description": "古老建筑，高书架，烛光照明",
  "atmosphere": "神秘，昏暗",
  "time": "不限"
}
```

### 道具提取 (Prop)

**提取内容**：
- 物品名称
- 外观描述
- 功能/用途
- 重要性

**示例输入**：
```
一把古老的魔杖，木质手柄，
顶端镶嵌着蓝色宝石，
能够释放强大的魔法。
```

**提取结果**：
```json
{
  "name": "魔法杖",
  "type": "prop",
  "description": "木质手柄，蓝色宝石，能释放魔法",
  "importance": "high"
}
```

## 文本分割策略

### 按章节分割
**适用场景**：小说、长篇故事

**分割标准**：
- 识别章节标题（第一章、Chapter 1等）
- 场景转换
- 时间跳跃
- 视角切换

**示例**：
```
第一章：相遇
内容...

第二章：冒险开始
内容...
```

### 按场景分割
**适用场景**：剧本、分镜脚本

**分割标准**：
- 地点变化
- 时间变化
- 主要动作完成

### 按长度分割
**适用场景**：没有明显结构的文本

**分割标准**：
- 每段500-1000字
- 保持语义完整
- 避免在对话中间分割

## 项目组织最佳实践

### 1. 命名规范

**项目命名**：
- 使用有意义的名称
- 避免特殊字符
- 建议格式：`[类型]_[主题]_[日期]`
- 示例：`video_magic_school_20260209`

**资产命名**：
- 角色：`char_[姓名]`
- 场景：`scene_[地点]`
- 道具：`prop_[物品]`

### 2. 资产分类

**按类型分类**：
```
characters/
  - 主角
  - 配角
  - 群众角色

scenes/
  - 室内场景
  - 室外场景
  - 特殊场景

props/
  - 关键道具
  - 装饰道具
```

**按章节分类**：
```
chapter_01/
  - 相关角色
  - 相关场景
  - 相关道具

chapter_02/
  ...
```

### 3. 元数据管理

**必填信息**：
- 项目名称
- 项目类型
- 视觉风格
- 创建时间

**推荐信息**：
- 项目描述
- 目标受众
- 预计时长/页数
- 标签/分类

## 风格选择指南

### anime（动漫风格）
**特点**：
- 大眼睛，夸张表情
- 鲜艳色彩
- 清晰线条
- 适合年轻受众

**适用项目**：
- 日式动画
- 漫画
- 轻小说改编

### realistic（写实风格）
**特点**：
- 真实比例
- 自然光影
- 细腻质感
- 成熟氛围

**适用项目**：
- 真人电影风格
- 纪录片
- 写实故事

### cinematic（电影风格）
**特点**：
- 电影级光照
- 宽银幕构图
- 戏剧化氛围
- 专业质感

**适用项目**：
- 短片
- 广告
- 高质量视频

### cartoon（卡通风格）
**特点**：
- 简化造型
- 明亮色彩
- 夸张动作
- 幽默轻松

**适用项目**：
- 儿童内容
- 搞笑短片
- 教育视频

## 常见问题处理

### 问题 1: 资产提取不准确
**解决方案**：
1. 确保文本描述清晰具体
2. 使用标准的叙事结构
3. 手动补充缺失信息
4. 使用 `extract_assets` 单独提取

### 问题 2: 章节分割不合理
**解决方案**：
1. 检查文本是否有明确的章节标记
2. 调整分割策略（按场景/按长度）
3. 手动指定分割点
4. 使用 `split_text_into_chapters` 的参数调整

### 问题 3: 项目结构复杂
**解决方案**：
1. 使用 `create_project_from_novel` 自动创建
2. 分阶段创建（先主要角色，后次要角色）
3. 使用标签和分类组织
4. 定期整理和归档

## 工作流示例

### 示例 1: 小说改编动画
```
1. 准备小说文本
2. create_project_from_novel(
     project_name="魔法学院",
     novel_text=novel_content,
     style="anime"
   )
3. 系统自动：
   - 提取10个主要角色
   - 提取15个场景
   - 提取5个关键道具
   - 分割成12个章节
4. 返回完整项目结构
5. 用户可以：
   - 为角色生成图像
   - 为场景生成背景
   - 创建分镜画布
```

### 示例 2: 手动创建项目
```
1. create_project(
     name="我的故事",
     project_type="video",
     style="cinematic"
   )
2. 手动添加角色资产
3. 手动添加场景资产
4. 创建画布工作流
5. 生成内容
```

### 示例 3: 分析现有文本
```
1. 用户提供剧本文本
2. extract_assets(text, asset_types=["character", "scene"])
3. 获得资产列表
4. 用户选择需要的资产
5. 添加到现有项目
```

## 性能优化建议

1. **批量操作**：一次性提取所有资产，而不是多次调用
2. **缓存结果**：提取的资产信息可以保存复用
3. **增量更新**：项目创建后，增量添加新资产
4. **定期清理**：删除不再使用的资产

## 与其他技能协作

- **canvas_workflow**：将项目资产组织到画布中
- **creative_generation**：为项目资产生成图像和视频
