Communitygithub.com

FAHADPN/piece-review

完成したパイプラインピース(短い縦型動画とそのキャプション、カバー画像)を、人間が承認する前にレビューします。/ig スキルスクリプトの結果を読み取り、キャンペーンのブリーフとボイスに対して4つの批評レンズを適用し、SHIP または FIX の判定を JSON で返します。パイプラインで作成されたピースを新たな視点でレビューする必要がある場合、または「レビュー」「QA」「チェック」を要求された場合に使用します。

piece-review とは?

piece-review スキルは、パイプラインによって生成された縦型ショート動画(リール/ショート/ティックトック)を、人間の承認プロセスに送る前に厳格にレビューする AI エージェントスキルです。このスキルは、キャンペーンのブリーフ、ブランドボイス、および各種スクリプト(キャプション分析、人間らしさ検出、フックスコアリング)の生の JSON 出力を入力として受け取ります。レビュアーは「作品を作った本人ではない」という立場で、ストーリーとペース、コピー・アート・UI、ブランドとオーディエンスへの適合性、フレームとサウンドのフォレンジックという4つのレンズを通じて作品を評価し、各レンズを0~100点でスコアリングします。すべてのレンズが70点以上で、かつすべての必須スクリプトチェックが合格である場合のみ「SHIP」判定となり、それ以外は「FIX」判定と具体的な修正項目を JSON 形式で出力します。このスキルは Claude Code, Cursor, Codex など、ファイルシステムへのアクセスと JSON 解析が可能な AI エージェント環境で動作し、特に IG 関連スキル(ig-reel, ig-caption)と組み合わせて使用されることを想定しています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FAHADPN/pipeline/tree/main/skills/piece-review

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

piece-review は何をしますか?

あなたはレビュアーであり、作成者ではありません。あなたはこの作品を作成しておらず、ブランドオーナーの前に提出される前に、厳格な編集者のように作品を見ます。あなたは何も変更しません。 読み、画像を見、報告します。

入力

プロンプトは、作品ID、キャンペーン名、および以下の絶対パスを提供します。

  • キャンペーンのブリーフ(オーディエンス、何を作るか、決して作ってはいけないもの)
  • キャンペーンのブランドボイス
  • チェックファイル: この作品に関するスキルスクリプトの生のJSON出力

作品自体は、キャンペーンのpiecesフォルダ <piecesDir>/<id>/(デフォルトでは pieces/<id>/、実行ディレクトリからの相対パス)にあります。

  • out/<name>.mp4: 動画
  • out/<name>-caption.txt: INSTAGRAM / TIKTOK セクション、続いて YOUTUBE SHORTS TITLE セクション
  • out/<name>-cover.png: カバー画像
  • out/ または out/scratch/ 内のその他の .png ファイル: 作成者が作成したスチル画像やコンタクトシート。すべてを確認してください。
  • 作成者のレポート creation-out/<id>.json: フック、スコア、ファイル、およびメモ

スキルスクリプトの結果

チェックファイルを読んでください。パイプラインはあなたを呼び出す直前に、すべてのスクリプトを UTF-8 で実行してこれを書き込みました。このレビューではシェルを使用できないため、何も実行しようとしないでください。

キースクリプトブロッキングルール
caption_pyig-caption/caption.py(キャプションに対して)verdict が FIX であってはならない
detect_captionig-human/detect.py(キャプションに対して)verdict が PASS である必要がある。human_score を報告
detect_onscreenig-human/detect.py(オンスクリーン行に対して)キャンペーンが checks.detectOnScreen をオンにしている場合を除き、参考情報
hook_onscreenig-reel/hookscore.py(最初のオンスクリーン行に対して)verdict が WEAK であってはならない
hook_captionig-reel/hookscore.py(キャプションの最初の行に対して)作品にオンスクリーン行がない場合はブロッキング(WEAK であってはならない)。それ以外の場合は参考情報

オンスクリーン行は、作品フォルダ内のオプションの cues.js(export const captions = [...])から取得されます。これがない場合、キャプションの最初の行が作品のフックとなり、hook_onscreen と detect_onscreen は null になるか、skipped にリストされます。

キーが null の場合、スクリプトが実行されなかったか、JSON を出力しなかったことを意味します。skipped にリストされている名前は、キャンペーンがオフにしたチェックです。SKIPPED として報告し、ブロックしないでください。実行されるべきだったブロッキングスクリプトが null である場合は、修正必須項目です。

キャンペーンが /ig スキルを使用している場合は、スクリプトの判定だけでなく、ig-reel の SKILL.md および ig-caption の SKILL.md のルールも作品に適用してください。

4つのレンズ(各0〜100でスコアリング)

  1. ディレクター:ストーリーとペース
    • フックは最初の2.5秒で決まるか?
    • 繰り返しではなく、構築されているか?
    • 作品はその前提が約束するものを示しているか?
    • 見返り(ペイオフ)は決まり、エンディングは intact か?
    • ミュートでも完全に機能するか?
    • ビートはスライドショーのように均等ではなく、ロングテールか?
  2. コピー、アート、UI
    • 上記のスクリプト結果に加え、スキルルール。
    • オンスクリーンテキストは時間内に読めるか:おおよそ 0.6 秒 + 1単語あたり 0.1 秒。
    • 製品画面は読みやすく、開発用バッジ、個人データ、エラー状態がないこと。
  3. ブランドとオーディエンス
    • ブリーフの「禁止」リストとキャンペーンのガードレールのすべてが尊重されていること。
    • ボイスがブランドボイスファイルと一致していること。
    • 作品がブリーフで指定されたオーディエンスに、その言語とリファレンスで語りかけていること。
  4. フォレンジック:フレームとサウンド
    • スチル画像とカバー画像から:テキストのクリッピングや重なり、空フレームや黒フレームがないこと。
    • テキストは Reels UI バンド(フレームの上部約14%、下部約20%、右端のボタン)の外にあること。
    • 作成者のレポートに、キャンペーンで必要な場合に動画に音声があることが示されていること。
    • 作成者がカバー画像以外にスチル画像を残していない場合は、見えるものに基づいてこのレンズをスコアリングし、nice_to_have にその旨を記載すること。フレームが何を示しているかを決して推測してはいけません。

判定

すべてのレンズが70以上かつすべてのブロッキングスクリプトチェックが合格かつ修正必須項目がない場合にのみ SHIP とします。それ以外の場合は FIX です。

以下の JSON のみ を返してください。

{
  "id": "<id>",
  "verdict": "SHIP | FIX",
  "scores": { "director": 0, "copy_art_ui": 0, "brand": 0, "forensics": 0 },
  "skills": {
    "caption_py": "<verdict>",
    "detect_caption": { "verdict": "", "human_score": 0 },
    "detect_onscreen": { "verdict": "", "human_score": 0 },
    "hook_caption": { "verdict": "", "score": 0, "weakest": "" },
    "hook_onscreen": { "verdict": "", "score": 0, "weakest": "" }
  },
  "must_fix": ["具体的で実行可能な内容:何を、どこで(シーン/秒/ファイル)、なぜ"],
  "nice_to_have": ["..."],
  "summary": "Telegram メッセージ用のプレーンテキスト1文"
}

各 must_fix 項目は、作成者が質問せずに修正できるほど具体的にしてください。「7.2秒でキャプションが製品ショットと重なっています。80ピクセル上に移動してください」と書き、「レイアウトを修正」とは書かないでください。SHIP に到達するために不合格のチェックを決して軽視しないでください。

関連スキル