| name | manage-project |
| description | 项目管理工具集。使用场景：(1) 分集切分——探测切分点并执行切分，(2) 批量添加角色/场景/道具到 project.json。提供 peek（预览）+ split（执行）的渐进式切分工作流，以及角色/场景/道具批量写入。 |
| user-invocable | false |
项目管理工具集
提供项目文件管理的命令行工具，主要用于分集切分和角色/场景/道具批量写入。
工具一览
| 脚本 | 功能 | 调用者 |
|---|
peek_split_point.py | 探测目标字数附近的上下文和自然断点 | 主 agent（阶段 2） |
split_episode.py | 执行分集切分，生成 episode_N.txt + _remaining.txt | 主 agent（阶段 2） |
add_assets.py | 批量添加角色/场景/道具到 project.json | subagent |
mcp__arcreel__get_video_capabilities（SDK tool） | 查当前项目视频模型能力（model 粒度，所有生成模式通用） | subagent（执行任务时自行查询） |
分集切分工作流
分集切分采用 peek → 用户确认 → split 的渐进式流程，由主 agent 在 manga-workflow 阶段 2 直接执行。
Step 1: 探测切分点
python .claude/skills/manage-project/scripts/peek_split_point.py --source {源文件} --target {目标字数}
参数：
--source：源文件路径（source/novel.txt 或 source/_remaining.txt）--target：目标有效字数--context：上下文窗口大小（默认 200 字符）
输出（JSON）：
total_chars：总有效字数target_offset：目标字数对应的原文偏移context_before / context_after：切分点前后上下文nearby_breakpoints：附近自然断点列表（按距离排序，最多 10 个）
Step 2: 执行切分
python .claude/skills/manage-project/scripts/split_episode.py --source {源文件} --episode {N} --target {目标字数} --anchor "{锚点文本}" --dry-run
python .claude/skills/manage-project/scripts/split_episode.py --source {源文件} --episode {N} --target {目标字数} --anchor "{锚点文本}"
参数：
--source：源文件路径--episode：集数编号--target：目标有效字数（与 peek 一致）--anchor：切分点的锚点文本（10-20 字符）--context：搜索窗口大小（默认 500 字符）--dry-run：仅预览，不写文件
定位机制：target 字数计算大致偏移 → 在 ±window 范围内搜索 anchor → 使用距离最近的匹配
输出文件：
source/episode_{N}.txt：前半部分source/_remaining.txt：后半部分（下一集的源文件）
角色/场景/道具批量写入
从项目目录内执行，自动检测项目名称：
⚠️ 必须单行，JSON 使用紧凑格式，不可用 \ 换行：
python .claude/skills/manage-project/scripts/add_assets.py --characters '{"角色名": {"description": "...", "voice_style": "..."}}' --scenes '{"场景名": {"description": "..."}}' --props '{"道具名": {"description": "..."}}'
字数统计规则
- 统计非空行的所有字符（包括标点）
- 空行（仅含空白字符的行）不计入
查视频模型能力
通过 MCP 工具查询（项目名由 session 绑定，无需传参）：
mcp__arcreel__get_video_capabilities({})
返回：JSON 文本，含 provider_id / model / supported_durations[] / max_duration / max_reference_images / source / default_duration / content_mode / generation_mode。
用途：所有 generation_mode（storyboard / grid / reference_video）的预处理 subagent 在执行时自查，用于决定单片段 / shot 时长。决策优先级：若 default_duration 非 null，优先采用为默认值；否则或特殊情况（reference_video 多 shot 组合贴近 max_duration、narration 长句需要更长）按规则从 supported_durations 选值。
错误：项目未找到或模型能力无法解析时返回 is_error: true，文本中包含原因。
