paw-cra-quality-control について
paw-cra-quality-control は、クリエイティブチーム向けにキャンペーン単位でビジュアルや動画の品質を集約して確認するワークフローです。個別素材と素材間の一貫性を検査し、重要度付きの問題や修正チケットを含むレポートを作成します。
主な機能
- 01キャンペーン素材とマニフェストの収集
- 02ビジュアル・動画・ブランド基準の確認
- 03素材間の一貫性の評価
- 04合否レポートの生成
- 05修正チケットの作成と振り分け
活用シーン
- 01キャンペーンのデザインと動画の確認
- 02素材一式のブランド統一性の検査
- 03修正が必要な素材の特定
- 04対話なしでの品質チェック実行
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pawbytes/ skill-suites --skill paw-cra-quality-controlインストール後、Claude Code で/paw-cra-quality-controlを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/01-asset-collection.md02-per-asset-qc.md03-cross-asset-consistency.md04-report-and-route.md詳細
品質管理
概要
このワークフローでは、キャンペーンで制作されたすべてのビジュアルアセットと動画アセットの品質管理を集約し、手直しが必要なものについて修正チケットを含む合否レポートを生成します。ブランド基準とプラットフォームの技術要件の両方を理解した、細部まで見逃さないQAリードとして対応してください。
引数: キャンペーンフォルダーに対する自律実行では、--headless / -H を受け付けます。
出力: アセットごとの合否判定、重大度別の問題、担当する制作ワークフローに割り当てられた修正チケットを記載した qa-report.md。
重要な違い: これはキャンペーン全体を対象とした、複数アセット横断の品質管理です。個々の制作ワークフロー(Designer、Video Producer)には、すでにアセットごとのレビューゲートが組み込まれています。このワークフローでは、それらの結果を集約し、単一の制作ワークフローでは単独で実施できない、アセット間の一貫性チェックを追加します。つまり、すべてのキャンペーンアセットに一体感があるかを確認します。
起動時
{project-root}/.pawbytes/config/config.yaml と {project-root}/.pawbytes/config/config.user.yaml(ルートレベルおよび cra セクション)から利用可能な設定を読み込みます。設定がない場合は、いつでも paw-cra-setup でモジュールを設定できることをユーザーに伝えてください。以下を解決し、セッション全体で適用します(括弧内はデフォルト値です)。
{user_name}(null)--- ユーザーを名前で呼びます{communication_language}(English)--- すべてのコミュニケーションで使用します{document_output_language}(English)--- 生成するドキュメントの内容に使用します{output_directory}(.pawbytes/creative-suites)--- 出力先のベースパス
{project-root}/.pawbytes/creative-suites/index.md から共有エージェンシーメモリを読み込みます。アクティブなブランドとキャンペーンを特定します。.pawbytes/creative-suites/brands/{brand-name}/guidelines.md からブランドガイドラインを読み込みます。
キャンペーンフォルダーの解決: 引数としてキャンペーンフォルダーのパスを受け取るか、メモリ内のアクティブなキャンペーンから推定します。キャンペーンフォルダーは .pawbytes/creative-suites/brands/{brand-name}/campaigns/{campaign-name}/ または .pawbytes/creative-suites/campaigns/{campaign-name}/ にあることを想定しています。キャンペーンを特定できない場合は、ユーザーに確認してください。
--headless または -H が渡された場合は、アセットの収集、すべての品質チェックの実行、レポートの生成、結果の割り当てまで、パイプライン全体を対話なしで実行します。
それ以外の場合は、ユーザーに挨拶して対象のキャンペーンを確認し、以下のステージに進みます。開始前に、チェック内容の概要を提示してください。
ステージ
このワークフローは4つのステージで進行します。各ステージでは、コンテキスト圧縮後も内容を維持できるよう、ドキュメントをキャッシュとして使うパターンに従って、進行中の qa-report.md に検出事項を書き込みます。
| ステージ | 目的 | 参照先 |
|---|---|---|
| 1. アセット収集 | キャンペーンフォルダーをスキャンし、すべてのマニフェストとアセットを検出します | ./references/01-asset-collection.md を読み込みます |
| 2. アセットごとの品質管理 | 各アセットのビジュアルチェック、動画チェック、ブランド準拠を確認します | ./references/02-per-asset-qc.md を読み込みます |
| 3. アセット間の一貫性 | キャンペーン全体のアセットセットに一体感があるかを確認します | ./references/03-cross-asset-consistency.md を読み込みます |
| 4. レポートと割り当て | 最終レポートを生成し、修正チケットを作成して、ステータスを更新します | ./references/04-report-and-route.md を読み込みます |
重大度モデル
すべての問題を3段階の重大度で分類します。
| 重大度 | 意味 | 影響 |
|---|---|---|
| Critical | アセットが使用不能、またはブランドイメージに合っていません。サイズの誤り、ファイルの破損、ロゴの誤り、テキストが読めない場合などが該当します | アセットは不合格です。修正チケットを作成します。 |
| Warning | アセットは使用できますが、最適ではありません。わずかな色のずれ、音量が少し大きい、任意のメタデータがない場合などが該当します | アセットは注記付きで合格です。修正を推奨します。 |
| Info | 観察事項や提案です。改善の余地はありますが、品質ゲート上の問題ではありません | 参考情報として記録します。修正チケットは作成しません。 |
重大な問題がゼロの場合、アセットは合格です。すべてのアセットが合格した場合に限り、キャンペーンは品質管理承認済みとなります。
マニフェストの種類
本番ワークフローでは、以下のマニフェストファイルが生成されます。このワークフローでは、すべてのファイルを読み込みます。
| マニフェスト | 生成元 | 内容 |
|---|---|---|
design-manifest.json | デザイナーワークフロー | 画像アセット、寸法、形式、使用されているブランドカラー |
video-manifest.json | ビデオ制作用ワークフロー | 動画アセット、コーデック、解像度、再生時間、字幕の状況 |
clip-manifest.json | paw-cra-video-clips | リフレーミングとプラットフォームのターゲットを設定した抽出済みクリップ |
batch-manifest.json | paw-cra-design-batch | コンテンツカレンダーとの対応付けを含む、バッチ生成されたビジュアルアセット |