webtoon-harness

webtoon-harness — ウェブトゥーン制作エージェントチーム

キーワード：webtoon harness · make a webtoon · produce a webtoon episode · next episode · redraw panel

トレンドデータの収集時には、すべての情報源サイトの利用規約、robots.txt、レート制限、著作権を遵守してください。また、生成したウェブトゥーンを公開する際には、プラットフォームおよび知的財産に関するルールを遵守してください。

webtoon-harness は、revfactory/webtoon-harness の Claude Code ハーネスを、インストール可能な jeo-skills プラグインとしてパッケージ化したものです。27 個の専門エージェントを4 つのフェーズごとに再構成されるチームに編成し、トレンドの調査 → 会話主体で緊張感が高く、各話にどんでん返しがあるシナリオの執筆 → まずキャラクターのリファレンスシートを作成 → 画像内に吹き出しを埋め込んだ 1 話あたり 50 枚以上のパネルを生成 → すべてのパネルが合格するまで生成と検証を繰り返す → 縦スクロール式ビューアーを組み立てる、という全工程を通じてウェブトゥーン 1 話を制作します。

エージェントチームを使用するには、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 が必要です。

このスキルを使う場面

• トレンド調査から完成した縦スクロール式ビューアーまで、ウェブトゥーン 1 話を制作する
• ウェブトゥーンのトレンドを調査する：ジャンルやトロープの勢い、プラットフォームのランキング、読者の反応、フックやどんでん返しのリバースエンジニアリング
• 各話にどんでん返しがあり、緊張感が高く会話の多いシナリオと、50 枚以上のパネルからなるビートシートを作成する
• まずキャラクターのリファレンスシートを作成する（話をまたいだ一貫性を保つ唯一の信頼できる情報源）
• 画像内に韓国語の吹き出しを埋め込んで 50 枚以上のパネルを一括生成し、検証して再生成する
• パネルをオーバーレイなしの縦スクロール式ビューアーに組み立て、リリースパッケージを作成する
• 続きの依頼：「next episode」、「stronger twist」、「redraw panel 23」、「re-run only the visual phase」

純粋なおすすめや批評（「何を読めばいいですか？」など）を求められた場合は、ハーネスを実行せず、そのまま回答してください。

インストール（プラグイン）

# 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 がエージェントと webtoon-orchestrator エントリーポイントスキルを検出できるようにします。references/install.md を参照してください。

実行モード：フェーズごとに再構成されるエージェントチーム

各セッションでアクティブになるチームは 1 つだけです。各フェーズでは、TeamCreate でチームを作成して実行し、次のフェーズのチームを作る前に TeamDelete を実行します。各チームは成果物を _workspace/ の下に残すため、次のチームはそれを Read で取得できます。すべてのチームメンバーと Agent 呼び出しには、model: "opus" を指定してください。

27 個のエージェント（4 チーム）

チーム	メンバー	役割
リサーチ	trend-scout, platform-ranker, audience-analyst, hook-analyst, trend-synthesizer	ジャンルやトロープの勢い · プラットフォームのランキングと連載構成 · 読者の反応や離脱 · フックやどんでん返しのリバースエンジニアリング → 企画ブリーフ 1 件
シナリオ	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	スタイルバイブルと一貫性・場所・吹き出しのトークン · リファレンスシート · ショットリスト · 吹き出しの文字入れ · プロンプトの統合 · パネルの並列生成 · 6 軸の検証ループ
組み立てと QA	episode-compositor, quality-reviewer, continuity-manager, showrunner	縦スクロール式ビューアーの組み立て · QA · 連続性の管理 · 承認とリリースパッケージ作成

全エージェントの一覧と出力 → 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）

調査チームは、プラットフォームのランキング、連載構成、コメントの反応パターンといったリアルタイムデータを収集します。Web 抽出には、場当たり的なブラウザーのデフォルト設定ではなく、scrapling スキルを使用します。実用上最も軽量な Scrapling モード（パーサーのみ → HTTP フェッチ → JS ブラウザー → ステルス）を選び、各サイトの利用規約、robots.txt、レート制限、著作権を遵守してください。すべての主張に出典 URL と観察日を添え、出典が食い違う場合は、どちらかを削除せず両方を記録してください。

references/trend-research-scrapling.md を参照してください。

設計原則

• 会話主導、高い緊張感、毎話にどんでん返し — 語りは最小限に抑え、キャラクターの会話とアクションを通じて緊張感、情報、逆転を伝えます。
• 1話あたり50コマ以上 — 縦スクロールのリズムに合わせて、ビートを細かく分割します。
• 一貫性を最優先 — すべてのプロンプトに参照シート → 一貫性トークン → ロケーショントークンを注入します。バリデーターは md5 の重複、唐突な背景の切り替わり、韓国語テキストの崩れを検出します。
• 画像内の吹き出し焼き込み — 吹き出しと韓国語のセリフはコマの PNG にレンダリングされるため、組み立ては画像を順番に並べるだけで完了し、テキストのオーバーレイは不要です（二重のキャプションを防止します）。
• 監査証跡 — すべての中間成果物を _workspace/ に保存し、決して削除しません。

フォローアップの振り分け

• 「次の話」 → フェーズ 0 のケース 2：世界観／スタイル／連続性を再利用し、03_episode 以降を再生成します。
• 「どんでん返しを強める」 → シナリオの一部を再実行（twist-master、script-editor）→ 影響を受ける後続フェーズを再実行します。
• 「コマ N を描き直す」 → ビジュアル工程の一部を再実行（prompt-smith で強化し、そのコマを panel-artist で再レンダリングし、panel-validator で再チェック）→ 再度組み立てます。
• 同じ種類のフィードバックが繰り返される（2 回以上） → 関連するスキル／エージェント定義の改善を提案します（ハーネスの進化）。変更を記録します。

制限とエラー処理

状況	対応
codex の全体的な遅延（450秒以上）	プランの制限を疑い、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 回です。上限を超えた場合は、現在の状態で進め、制限に達したことを報告します

参考資料

• エージェントチーム（27 エージェント）
• ワークフロー（6 フェーズとデータフロー）
• scrapling によるトレンド調査
• インストール／スキャフォールド
• revfactory/webtoon-harness（MIT）
• scrapling スキル · harness2 スキル
• Agent Skills Specification