webtoon-harness

webtoon-harness — 网漫制作 Agent 团队

关键词：webtoon harness · make a webtoon · produce a webtoon episode · next episode · redraw panel

收集趋势数据时，请遵守所有来源网站的服务条款、robots.txt、速率限制和版权规定；发布生成的网漫时，也请遵守平台和 IP 规则。

webtoon-harness 将 revfactory/webtoon-harness Claude Code harness 打包为可安装的 jeo-skills 插件。它通过 27 个专业 Agent，端到端制作一集网漫，这些 Agent 被组织为 4 个按阶段重建的团队：研究热门趋势 → 撰写以对话推动、高张力、每集都有反转的剧情 → 优先绘制角色参考表 → 每集绘制 50+ 个分镜，并将对话气泡直接嵌入图像 → 运行生成–验证循环，直到每个分镜都通过 → 组装纵向滚动浏览器。

Agent 团队需要启用 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。

何时使用此技能

• 从趋势调研到完成纵向滚动浏览器，制作一整集网漫
• 调研网漫趋势：类型／套路热度、平台排名、读者反应、钩子／反转逆向分析
• 撰写对话密集、高张力、每集都有反转的剧情，以及包含 50+ 个分镜的节拍表
• 优先绘制角色参考表（跨集保持一致性的唯一事实来源）
• 批量绘制 50+ 个分镜，将韩语对话气泡直接嵌入图像，然后进行验证并重新生成
• 将分镜组装成无叠加元素的纵向滚动浏览器，并打包发布版本
• 后续请求：“下一集”“反转更强”“重绘第 23 格”“仅重新运行视觉阶段”

如果只是寻求推荐或评论（“我该看什么？”），请直接回答，不要运行 harness。

安装（插件）

# Install this routing skill from jeo-skills
npx skills add https://github.com/akillness/jeo-skills --skill webtoon-harness

# Scaffold the full upstream harness (27 agents + 6 skills) into your project's .claude/
bash scripts/install.sh                       # into ./ (current project)
TARGET=/path/to/project bash scripts/install.sh
GLOBAL=1 bash scripts/install.sh              # also install the skill globally (npx skills add -g)

安装程序支持幂等操作。它会克隆 revfactory/webtoon-harness，并将其中的 .claude/agents/ 和 .claude/skills/ 复制到目标项目，以便 Claude Code 发现这些 Agent 和 webtoon-orchestrator 入口技能。请参阅 references/install.md。

执行模式：按阶段重建 Agent 团队

每个会话中仅有一个团队处于活动状态。每个阶段都使用 TeamCreate 创建团队并运行，然后在 创建下一阶段的团队之前使用 TeamDelete 删除当前团队。每个团队都会将产物留在 _workspace/ 下，以便下一团队使用 Read 获取。生成每个团队成员和 Agent 调用时，都要指定 model: "opus"。

27 个 Agent（4 个团队）

团队	成员	职责
调研	trend-scout, platform-ranker, audience-analyst, hook-analyst, trend-synthesizer	类型／套路热度 · 平台排名与连载结构 · 读者反应／流失点 · 钩子／反转逆向分析 → 一份规划简报
剧情	concept-architect, worldbuilder, character-designer, series-plotter, twist-master, tension-engineer, episode-outliner, dialogue-writer, script-editor	高概念 · 世界构建 · 角色阵容 · 系列主线 · 每集反转 · 张力曲线 · 50+ 格分镜节拍表 · 对话驱动的剧本 · 编辑修订
视觉	art-director, ref-sheet-artist, panel-director, letterer, prompt-smith, panel-artist-a/b/c, panel-validator	风格指南与一致性／地点／气泡标记 · 参考表 · 镜头列表 · 字体设计 · 提示词综合 · 并行绘制分镜 · 六轴验证循环
组装与 QA	episode-compositor, quality-reviewer, continuity-manager, showrunner	组装纵向滚动浏览器 · QA · 连贯性跟踪 · 最终签核与发布打包

完整 Agent 名单及输出 → references/agent-teams.md。

工作流 — 6 个阶段

Phase 0  Context check     — new series vs next episode; reuse world/style/continuity
Phase 1  Prep              — record brief, create _workspace/
Phase 2  Research          — 4 parallel researchers → trend-brief.md   (web data via scrapling)
Phase 3  Scenario          — high-concept → world → cast → arc → {twist, tension} → beatsheet → script_final
Phase 4  Visual            — style bible → reference sheets FIRST → shotlist+lettering → prompts
                             → 50+ panels (codex-image, batches of 5, ≤5 concurrent)
                             ⇄ panel-validator 6-axis validate–regenerate loop → validation.md
Phase 5  Assembly & QA     — no-overlay index.html (bubbles baked into panels) → qa PASS → RELEASE/ep{NN}/
Phase 6  Wrap-up           — continuity update, next-episode seed

详细数据流和各阶段输出 → references/workflow.md。

通过 scrapling 进行趋势研究（阶段 2）

研究团队会收集实时数据——平台排名、序列化结构、评论反应模式——这些网页提取工作通过 scrapling 技能完成，而不是使用临时的浏览器默认设置。选择最轻量且可行的 Scrapling 模式（仅解析器 → HTTP 抓取 → JS 浏览器 → 隐身模式），并遵守各网站的服务条款、robots.txt、速率限制和版权规定。每项论断都附上来源 URL 和观察日期；如果来源之间存在冲突，应同时记录，不要删除任何一方。

参见 references/trend-research-scrapling.md。

设计原则

• 对话驱动、高张力、每集都有反转——尽量减少旁白；通过角色对话和动作传递张力、信息和反转。
• 每集 50 格以上——细化节拍划分，以适应纵向滚动的节奏。
• 一致性优先——在每个提示词中注入参考设定表 → 一致性令牌 → 地点令牌；验证器会检测 md5 重复、背景突然切换和韩文文本损坏。
• 将对话气泡烘焙进图像——对话气泡和韩文对白直接渲染到分格 PNG 中，因此组装时只需按顺序拼接图像条，无需叠加文本（避免重复添加字幕）。
• 审计记录——在 _workspace/ 下保留每一份中间产物；绝不删除。

后续路由

• “下一集” → 阶段 0 案例 2：沿用世界观／风格／连续性，从 03_episode 开始重新生成。
• “反转更强” → 部分重新运行 Scenario（twist-master、script-editor）→ 重新运行受影响的下游阶段。
• “重绘第 N 格” → 部分重新运行 Visual（prompt-smith 强化提示 + 对应 panel-artist 重新渲染 + panel-validator 重新检查）→ 重新组装。
• 同类反馈反复出现（2 次以上）→ 建议改进相关技能／Agent 定义（框架演进）；记录此次变更。

限制与错误处理

情况	处理方式
codex 全局变慢（450s+）	怀疑是计划限制 → 检查 codex login status，降低并发数，然后重试
角色偏移	panel-validator 执行 C1 REGEN → 强化参考锚点／身份标记，重新渲染
韩文文本损坏	prompt-smith 强化引号／粗体／短文本 → 重新渲染；如果尝试 3 次后仍不稳定，则对最佳版本标记 ACCEPT-FLAG 并注明
少于 50 格	请 episode-outliner/panel-director 拆分更多节拍
反转不明确（QA REDO）	反馈给 twist-master/script-editor 或 letterer，重新修改
无限返工	每格最多重新生成 3 次；每个阶段最多返工 2 轮。超出限制后，按当前状态继续并报告限制

参考资料

• Agent 团队（27 个 Agent）
• 工作流（6 个阶段和数据流）
• 通过 scrapling 进行趋势研究
• 安装／搭建脚手架
• revfactory/webtoon-harness（MIT）
• scrapling 技能 · harness2 技能
• Agent Skills 规范