项目管理工具集。使用场景:(1) 分集切分——探测切分点并执行切分,(2) 批量添加角色/场景/道具到 project.json。提供 peek(预览)+ split(执行)的渐进式切分工作流,以及角色/场景/道具批量写入。
提供项目文件管理的命令行工具,主要用于分集切分和角色/场景/道具批量写入。
| 脚本 | 功能 | 调用者 |
|---|---|---|
peek_split_point.py | 探测目标字数附近的上下文和自然断点 | 主 agent(阶段 2) |
split_episode.py | 执行分集切分,生成 episode_N.txt + _remaining.txt | 主 agent(阶段 2) |
add_assets.py | 批量添加角色/场景/道具到 project.json | subagent |
分集切分采用 peek → 用户确认 → split 的渐进式流程,由主 agent 在 manga-workflow 阶段 2 直接执行。
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 个)# Dry run(仅预览)
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": "..."}}'