项目管理工具集

提供项目文件管理的命令行工具，主要用于分集切分和角色/线索批量写入。

工具一览

分集切分工作流

分集切分采用 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: 执行切分

# 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_characters_clues.py --characters '{"角色名": {"description": "...", "voice_style": "..."}}' --clues '{"线索名": {"type": "prop", "description": "...", "importance": "major"}}'

字数统计规则

• 统计非空行的所有字符（包括标点）
• 空行（仅含空白字符的行）不计入