1仕組みと動作原理
3つのサブコマンド CLI（generate / from-script / create-script）：generate がメインワークフローで、主人公画像＋テーマから絵コンテ脚本を自動生成し、各カットごとに動画を出力します。
skills/canghe-manga-drama/SKILL.md
python3 scripts/manga_drama.py generate
ここでの処理内容：SKILL.md には3つの呼び出し方法のみが記載されており、実際のロジックは manga_drama.py にあります。
いわゆる「主人公認識」はファイル名に基づくヒューリスティックに過ぎず、画像ファイル名の stem を取得して1行の説明文を組み立てるだけで、画像認識は一切行っていません。
skills/canghe-manga-drama/scripts/seedance_video.py
return f"图片中的主角（基于文件名: {filename}）"
ここでの処理内容：analyze_image() はファイル名に基づいたプレースホルダーの説明を返すだけであり、「キャラクターの特徴を抽出する」という説明とは乖離があります。
5種類の絵コンテテンプレート（introduction/action/emotion/interaction/ending）があり、それぞれプレースホルダー付きの default_prompt を持ち、generate_scene_prompt でフォーマットおよび値の補完を行います。
skills/canghe-manga-drama/scripts/manga_drama.py
"default_prompt": "{character}站在画面中央，微笑看向镜头，背景是柔和的光晕，漫画风格，温馨氛围，{style}"
ここでの処理内容：各カットのプロンプトはテンプレート＋主人公の説明＋テーマで組み立てられるため、ユーザーがプロンプトを書く必要はありません。
絵コンテ脚本は JSON としてディスクに保存され（create_drama_script）、ユーザーが編集した脚本を読み込むことも可能（from-script）で、カットごとのカスタムプロンプトに対応しています。
skills/canghe-manga-drama/scripts/manga_drama.py
with open(output_file, 'w', encoding='utf-8') as f:
ここでの処理内容：JSON 中間成果物によって「脚本作成」と「動画出力」が疎結合化され、編集や再利用が可能になっています。
カットごとに seedance_video.generate_video_task を呼び出します。キャラクターの一貫性を保つため、主人公画像を base64 data URI として読み込み、各カットのリクエストに注入します。
skills/canghe-manga-drama/scripts/seedance_video.py
img_url = f"data:image/{mime_type};base64,{img_base64}"
ここでの処理内容：同一の主人公画像がすべてのカットの参照画像として使用されます。
認証情報は ARK_API_KEY（require_env_key）から取得され、Volcengine Ark Seedance の非同期タスクを呼び出して完了までポーリングします。
skills/canghe-manga-drama/scripts/seedance_video.py
require_env_key("ARK_API_KEY")
ここでの処理内容：main と seedance_video のそれぞれでキーの検証を1回行い、欠落している場合は終了します。
スクリプトは TLS 証明書の検証を明示的に無効化（CERT_NONE）しており、生成結果は curl サブプロセスを使用してダウンロードされます。
skills/canghe-manga-drama/scripts/seedance_video.py
ssl_context.verify_mode = ssl.CERT_NONE
ここでの処理内容：「SSL検証を無視」というコメントがあり、これがレッド判定の直接的な根拠となっています。
成果物は ~/Desktop/drama_{title}/ に出力され、1カットにつき1つの mp4 が生成されます。単一カットが失敗しても全体は中断されません（try/except で継続）。
skills/canghe-manga-drama/SKILL.md
├── scene_1_introduction.mp4 # 分镜1
ここでの処理内容：generate_drama がカットごとに順次生成し、成功したパスを収集します。
任意の --send-feishu パラメータは CLI で受け付けられそのまま渡されますが、バンドルに含まれる生成コード内に Feishu への送信実装は見当たりません。
skills/canghe-manga-drama/SKILL.md
| `--send-feishu` | ❌ | 发送到飞书 |
ここでの処理内容：この機能は未完成であるか、提示されていない外部手順に依存している疑いがあり、ドキュメントと実装の乖離に該当します。
2コア機能
01主人公認識 ＋ 自動絵コンテ（テーマに応じたマルチカット脚本の自動生成）
025種類の組み込み絵コンテタイプ（登場/アクション/感情/インタラクション/結末）
033つのサブコマンド：generate（ワンクリック）/ from-script（脚本指定）/ create-script（テンプレート作成）
04画像からの動画生成とキャラクターの一貫性（全カットで同一の主人公画像を使用）
05カスタム絵コンテ脚本（JSON 内の prompt フィールドの編集）
06漫劇動画の仕様（9:16 縦型、1080p、1カットあたりデフォルト5秒）
07固定の出力ディレクトリ構造 drama_{title}/scene_N_type.mp4
08任意の --send-feishu による Feishu への送信（宣言された機能）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | python3（运行自带脚本） |
| cli | curl（下载生成视频） |
| api | 火山方舟 Seedance 视频生成 |
| package | 仓库共享模块 common/env_utils（load_env / require_env_key） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
隔離環境で実行、都度明示的な認可
管理者向け
厳格な認可、全量監査、コンプライアンス確認
判定根拠（ファイルパスと抜粋）
- SKILL.md / 脚本: 未公開またはリバースエンジニアリングされたプライベート API の呼び出し / クライアント識別の偽装
- SKILL.md / 脚本参数: 自動検知の回避、ホストサンドボックスの無効化、または SSL 証明書検証のスキップを含む
- scripts/: ローカルスクリプトまたはコマンドの実行: python3 scripts/manga_drama.py <generate|from-script|create-script>（SKILL.m
- 网络端点: 外部ネットワークアクセスの宣言: POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks（作成
- 本地工作目录: ファイルの読み書きと成果物の出力: 絵コンテ脚本 JSON（create_drama_script が output_file に書き込み）
監査ノート： レッド：seedance_video.py が TLS 証明書検証を明示的に無効化しており（ssl_context.check_hostname=False、ssl_context.verify_mode=ssl.CERT_NONE、「SSL検証を無視」とのコメントあり）、分類基準における「セキュリティのダウングレード（TLS検証の無効化）」に該当するため、デフォルト経路であるかどうかにかかわらずレッド判定となります。また、ARK_API_KEY を読み取り、ユーザーの主人公画像やプロンプトを Volcengine Ark の生成バックエンドへ外部送信しています（オレンジ基準の特徴）。ただし、レッド基準はセキュリティダウングレードを最優先で評価するためレッドと確定しました。リバースエンジニアリング、なりすまし、大量スクレイピング、任意コード実行はなく、shell=True も使用されていません。
5二重目の独立検証
- [ok] 是否关闭 TLS 校验 — seedance_video.py 开头 ssl_context.check_hostname=False、ssl_context.verify_mode=ssl.CERT_NONE（注释「忽略SSL验证」），后续两处 urllib.request.urlopen 均带该 context；确为安全降级，判红档的直接依据。
- [discrepancy] 「主角识别」宣称是否名副其实 — SKILL.md 核心功能写「主角识别：分析提供的角色图片，提取角色特征」，但 seedance_video.analyze_image 只取图片文件名 stem 并返回「图片中的主角（基于文件名: xxx）」，未做任何图像识别——属能力夸大。
- [discrepancy] --send-feishu 是否有实现 — generate/from-script 均有 --send-feishu 参数并一路传递，但 bundle 展示的 seedance_video.generate_video_task 函数体内未见任何飞书发送逻辑，SKILL.md 也未给实现细节——疑似未完成或依赖未展示的外部步骤。
- [discrepancy] 声明依赖 seedance-video-generation 技能 — SKILL.md 写「需要依赖技能：seedance-video-generation」并引用 ../seedance-video-generation-1.0.3/SKILL.md，但实际自带 scripts/seedance_video.py 直连 API（注释「使用直接 API 调用（无需 SDK）」）——声明与实际实现不一致。
- [ok] 网络调用与凭证读取点 — urllib 两处（建任务、轮询）+ curl 一处（下载）；BASE_URL 固定 ark.cn-beijing.volces.com/api/v3。require_env_key('ARK_API_KEY') 在 manga_drama.main 与 seedance_video.generate_video_task 中各出现一次。
- [ok] 写盘点 — 三处落点：create_drama_script 的 open(output_file,'w')、generate_drama 的 drama_dir.mkdir(parents=True, exist_ok=True)、download_video 的 curl -o；无删除操作。
- [unlocatable] env_utils 依赖能否在 skill 内定位 — 两个脚本都把 ../../../common 插入 sys.path 后 import env_utils；该模块不在本 skill 目录内（bundle §1 仅列出 SKILL.md 与 2 个 py），bundle 内无法确认其存在与实现。
- [ok] quote 逐条复核 — 本报告全部 evidence.quote 以子串方式回 bundle 原文比对，无编造。
6結論
最適な用途： マンガ風のショートドラマやキャラクター物語動画を迅速に制作したいクリエイター、編集可能かつスクリプト化可能な絵コンテワークフローを求めるユーザー。
不向きな用途： 通信の安全性や画像データの外部送信に厳しい環境（スクリプトで TLS 検証が無効化されているため）、本格的な画像認識によるキャラクター特徴の抽出を期待するユーザー。
Install Agent-Ready
① Verified Mirror 2026-10-10
Option A · Direct DownloadDownload manga-drama.tar.gz
sha256:
Option B · Copy Guide for Agentaa82a767e5ae8459…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit dd0bf35595.